Update README.md

packages/browseros-agent/apps/agent/CLAUDE.md

@@ -12,7 +12,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 |------|------------|---------|
 | Folders | kebab-case | `ai-settings/`, `jtbd-popup/`, `llm-hub/` |
 | React components (.tsx) | PascalCase | `AISettingsPage.tsx`, `SurveyHeader.tsx` |
-| Hooks (.ts) | camelCase with `use` prefix | `useVoiceInput.ts`, `useMessageTree.ts` |
+| Hooks (.ts) | camelCase with `use` prefix | `useRunWorkflow.ts`, `useVoiceInput.ts` |
 | Non-component files (.ts) | lowercase | `types.ts`, `models.ts`, `storage.ts` |
 
 ## Project Overview

packages/browseros-agent/apps/agent/components/sidebar/SettingsSidebar.tsx

@@ -4,6 +4,7 @@ import {
   Bot,
   Compass,
   CreditCard,
+  GitBranch,
   MessageSquare,
   Palette,
   RotateCcw,
@@ -85,6 +86,12 @@ const primarySettingsSections: NavSection[] = [
         icon: CreditCard,
         feature: Feature.CREDITS_SUPPORT,
       },
+      {
+        name: 'Workflows',
+        to: '/workflows',
+        icon: GitBranch,
+        feature: Feature.WORKFLOW_SUPPORT,
+      },
     ],
   },
 ]

packages/browseros-agent/apps/agent/entrypoints/app/App.tsx

@@ -11,6 +11,7 @@ import { Onboarding } from '../onboarding/index/Onboarding'
 import { StepsLayout } from '../onboarding/steps/StepsLayout'
 import { AISettingsPage } from './ai-settings/AISettingsPage'
 import { ConnectMCP } from './connect-mcp/ConnectMCP'
+import { CreateGraphWrapper } from './create-graph/CreateGraphWrapper'
 import { CustomizationPage } from './customization/CustomizationPage'
 import { SurveyPage } from './jtbd-agent/SurveyPage'
 import { AuthLayout } from './layout/AuthLayout'
@@ -28,6 +29,7 @@ import { SearchProviderPage } from './search-provider/SearchProviderPage'
 import { SkillsPage } from './skills/SkillsPage'
 import { SoulPage } from './soul/SoulPage'
 import { UsagePage } from './usage/UsagePage'
+import { WorkflowsPageWrapper } from './workflows/WorkflowsPageWrapper'
 
 function getSurveyParams(): { maxTurns?: number; experimentId?: string } {
   const params = new URLSearchParams(window.location.search)
@@ -51,7 +53,9 @@ const OptionsRedirect: FC = () => {
     soul: '/home/soul',
     skills: '/home/skills',
     'jtbd-agent': '/settings/survey',
+    workflows: '/workflows',
     scheduled: '/scheduled',
+    'create-graph': '/workflows/create-graph',
   }
 
   const newPath = routeMap[path] || '/settings/ai'
@@ -86,6 +90,7 @@ export const App: FC = () => {
 
           {/* Primary nav routes */}
           <Route path="connect-apps" element={<ConnectMCP />} />
+          <Route path="workflows" element={<WorkflowsPageWrapper />} />
           <Route path="scheduled" element={<ScheduledTasksPage />} />
         </Route>
 
@@ -103,6 +108,9 @@ export const App: FC = () => {
           </Route>
         </Route>
 
+        {/* Full-screen without sidebar */}
+        <Route path="workflows/create-graph" element={<CreateGraphWrapper />} />
+
         {/* Onboarding routes - no sidebar, no auth required */}
         <Route path="onboarding">
           <Route index element={<Onboarding />} />

packages/browseros-agent/apps/agent/entrypoints/app/ai-settings/NewProviderDialog.tsx

@@ -305,14 +305,9 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
     [modelInfoList],
   )
 
-  const filteredModels = useMemo(() => {
-    if (!modelSearch) return modelInfoList
-    const fuzzyResults = modelFuse.search(modelSearch).map((r) => r.item)
-    const hasExactMatch = fuzzyResults.some((m) => m.modelId === modelSearch)
-    if (hasExactMatch) return fuzzyResults
-    const customEntry = { modelId: modelSearch, contextLength: 0 }
-    return [customEntry, ...fuzzyResults]
-  }, [modelSearch, modelFuse, modelInfoList])
+  const filteredModels = modelSearch
+    ? modelFuse.search(modelSearch).map((r) => r.item)
+    : modelInfoList
 
   // Handle provider type change (user-initiated via Select)
   const handleTypeChange = (newType: ProviderType) => {
@@ -901,16 +896,17 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
                             value={modelSearch}
                             onValueChange={setModelSearch}
                             onKeyDown={(e) => {
-                              if (e.key === 'Enter' && modelSearch) {
+                              if (
+                                e.key === 'Enter' &&
+                                modelSearch &&
+                                filteredModels.length === 0
+                              ) {
                                 e.preventDefault()
-                                e.stopPropagation()
                                 form.setValue('modelId', modelSearch)
                                 track(MODEL_SELECTED_EVENT, {
                                   provider_type: watchedType,
                                   model_id: modelSearch,
-                                  is_custom_model: !modelInfoList.some(
-                                    (m) => m.modelId === modelSearch,
-                                  ),
+                                  is_custom_model: true,
                                 })
                                 setModelPickerOpen(false)
                                 setModelSearch('')
@@ -922,43 +918,35 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
                               No models found. Press Enter to use &quot;
                               {modelSearch}&quot;
                             </CommandEmpty>
-                            {filteredModels.length > 0 && (
-                              <CommandGroup>
-                                {filteredModels.map((model) => (
-                                  <CommandItem
-                                    key={model.modelId}
-                                    value={model.modelId}
-                                    onSelect={() => {
-                                      form.setValue('modelId', model.modelId)
-                                      track(MODEL_SELECTED_EVENT, {
-                                        provider_type: watchedType,
-                                        model_id: model.modelId,
-                                        context_window: model.contextLength,
-                                        is_custom_model: !modelInfoList.some(
-                                          (m) => m.modelId === model.modelId,
-                                        ),
-                                      })
-                                      setModelPickerOpen(false)
-                                      setModelSearch('')
-                                    }}
-                                  >
-                                    <span className="flex-1 truncate">
-                                      {model.modelId}
-                                    </span>
-                                    {model.contextLength > 0 && (
-                                      <span className="ml-2 shrink-0 rounded-md bg-muted px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
-                                        {formatContextWindow(
-                                          model.contextLength,
-                                        )}
-                                      </span>
-                                    )}
-                                    {field.value === model.modelId && (
-                                      <Check className="ml-2 h-4 w-4 shrink-0" />
-                                    )}
-                                  </CommandItem>
-                                ))}
-                              </CommandGroup>
-                            )}
+                            <CommandGroup>
+                              {filteredModels.map((model) => (
+                                <CommandItem
+                                  key={model.modelId}
+                                  value={model.modelId}
+                                  onSelect={() => {
+                                    form.setValue('modelId', model.modelId)
+                                    track(MODEL_SELECTED_EVENT, {
+                                      provider_type: watchedType,
+                                      model_id: model.modelId,
+                                      context_window: model.contextLength,
+                                      is_custom_model: false,
+                                    })
+                                    setModelPickerOpen(false)
+                                    setModelSearch('')
+                                  }}
+                                >
+                                  <span className="flex-1 truncate">
+                                    {model.modelId}
+                                  </span>
+                                  <span className="ml-2 shrink-0 rounded-md bg-muted px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
+                                    {formatContextWindow(model.contextLength)}
+                                  </span>
+                                  {field.value === model.modelId && (
+                                    <Check className="ml-2 h-4 w-4 shrink-0" />
+                                  )}
+                                </CommandItem>
+                              ))}
+                            </CommandGroup>
                           </CommandList>
                         </Command>
                       </PopoverContent>

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/CreateGraph.tsx

@@ -0,0 +1,484 @@
+import { useChat } from '@ai-sdk/react'
+import { DefaultChatTransport, type UIMessage } from 'ai'
+import { compact } from 'es-toolkit/array'
+import type { FC, FormEvent } from 'react'
+import { useEffect, useRef, useState } from 'react'
+import { useSearchParams } from 'react-router'
+import useDeepCompareEffect from 'use-deep-compare-effect'
+import type { Provider } from '@/components/chat/chatComponentTypes'
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from '@/components/ui/alert-dialog'
+import {
+  ResizableHandle,
+  ResizablePanel,
+  ResizablePanelGroup,
+} from '@/components/ui/resizable'
+import { useChatRefs } from '@/entrypoints/sidepanel/index/useChatRefs'
+import { useAgentServerUrl } from '@/lib/browseros/useBrowserOSProviders'
+import {
+  GRAPH_SAVED_EVENT,
+  GRAPH_UPDATED_EVENT,
+  NEW_GRAPH_CREATED_EVENT,
+} from '@/lib/constants/analyticsEvents'
+import { useLlmProviders } from '@/lib/llm-providers/useLlmProviders'
+import { track } from '@/lib/metrics/track'
+import { useRpcClient } from '@/lib/rpc/RpcClientProvider'
+import { sentry } from '@/lib/sentry/sentry'
+import { useWorkflows } from '@/lib/workflows/workflowStorage'
+import { GraphCanvas } from './GraphCanvas'
+import { GraphChat } from './GraphChat'
+import { WorkflowsChatHeader } from './WorkflowsChatHeader'
+
+type MessageType = 'create-graph' | 'update-graph' | 'run-graph'
+
+type GraphMessageMetadata = {
+  messageType?: MessageType
+  codeId?: string
+  graph?: GraphData
+  window?: chrome.windows.Window
+}
+
+export type GraphData = {
+  nodes: {
+    id: string
+    type: string
+    data: {
+      label: string
+    }
+  }[]
+  edges: {
+    id: string
+    source: string
+    target: string
+  }[]
+}
+
+const getLastMessageText = (messages: UIMessage[]) => {
+  const lastMessage = messages[messages.length - 1]
+  if (!lastMessage) return ''
+  return lastMessage.parts
+    .filter((part) => part.type === 'text')
+    .map((part) => part.text)
+    .join('')
+}
+
+export const CreateGraph: FC = () => {
+  const [searchParams] = useSearchParams()
+  const workflowIdParam = searchParams.get('workflowId')
+
+  const [graphName, setGraphName] = useState('')
+  const [codeId, setCodeId] = useState<string | undefined>(undefined)
+  const [graphData, setGraphData] = useState<GraphData | undefined>(undefined)
+  const [savedWorkflowId, setSavedWorkflowId] = useState<string | undefined>(
+    undefined,
+  )
+  const [savedCodeId, setSavedCodeId] = useState<string | undefined>(undefined)
+  const [isInitialized, setIsInitialized] = useState(!workflowIdParam)
+  const [canvasPanelSize, setCanvasPanelSize] = useState<
+    { asPercentage: number; inPixels: number } | undefined
+  >(undefined)
+
+  const [query, setQuery] = useState('')
+  const [showDiscardDialog, setShowDiscardDialog] = useState(false)
+
+  const { workflows, addWorkflow, editWorkflow } = useWorkflows()
+  const { providers: llmProviders, setDefaultProvider } = useLlmProviders()
+  const rpcClient = useRpcClient()
+
+  // Initialize edit mode when workflowId is provided
+  useDeepCompareEffect(() => {
+    if (!workflowIdParam || isInitialized) return
+
+    const workflow = workflows.find((w) => w.id === workflowIdParam)
+    if (!workflow) return
+
+    const initializeEditMode = async () => {
+      setGraphName(workflow.workflowName)
+      setCodeId(workflow.codeId)
+      setSavedWorkflowId(workflow.id)
+      setSavedCodeId(workflow.codeId)
+
+      try {
+        const response = await rpcClient.graph[':id'].$get({
+          param: { id: workflow.codeId },
+        })
+
+        if (response.ok) {
+          const data = await response.json()
+          if ('graph' in data && data.graph) {
+            setGraphData(data.graph as GraphData)
+          }
+        }
+      } catch (error) {
+        sentry.captureException(error, {
+          extra: {
+            message: 'Failed to fetch graph data from the server',
+            codeId: workflow.codeId,
+          },
+        })
+      }
+
+      setIsInitialized(true)
+    }
+
+    initializeEditMode()
+  }, [workflowIdParam, workflows, isInitialized, rpcClient])
+
+  const updateQuery = (newQuery: string) => {
+    setQuery(newQuery)
+  }
+
+  const onSubmit = (e: FormEvent) => {
+    e.preventDefault()
+    if (codeId) {
+      sendMessage({
+        text: query,
+        metadata: {
+          messageType: 'update-graph' as MessageType,
+          codeId,
+        },
+      })
+      track(GRAPH_UPDATED_EVENT)
+    } else {
+      sendMessage({
+        text: query,
+        metadata: {
+          messageType: 'create-graph' as MessageType,
+        },
+      })
+      track(NEW_GRAPH_CREATED_EVENT)
+    }
+    setQuery('')
+  }
+
+  const {
+    baseUrl: agentServerUrl,
+    isLoading: _isLoadingAgentUrl,
+    error: agentUrlError,
+  } = useAgentServerUrl()
+
+  const {
+    selectedLlmProviderRef,
+    enabledMcpServersRef,
+    enabledCustomServersRef,
+    personalizationRef,
+    selectedLlmProvider,
+    isLoadingProviders,
+  } = useChatRefs()
+
+  const agentUrlRef = useRef(agentServerUrl)
+  const codeIdRef = useRef(codeId)
+
+  useEffect(() => {
+    agentUrlRef.current = agentServerUrl
+    codeIdRef.current = codeId
+  }, [agentServerUrl, codeId])
+
+  const { sendMessage, stop, status, messages, error, setMessages } = useChat({
+    transport: new DefaultChatTransport({
+      prepareSendMessagesRequest: async ({ messages }) => {
+        const lastMessage = messages[messages.length - 1]
+        const lastMessageText = getLastMessageText(messages)
+        const metadata = lastMessage.metadata as
+          | GraphMessageMetadata
+          | undefined
+
+        if (metadata?.messageType === 'create-graph') {
+          return {
+            api: `${agentUrlRef.current}/graph`,
+            body: {
+              query: lastMessageText,
+            },
+          }
+        }
+
+        if (metadata?.messageType === 'update-graph' && codeIdRef.current) {
+          return {
+            api: `${agentUrlRef.current}/graph/${codeIdRef.current}`,
+            body: {
+              query: lastMessageText,
+            },
+          }
+        }
+
+        if (metadata?.messageType === 'run-graph' && codeIdRef.current) {
+          const provider = selectedLlmProviderRef.current
+          const enabledMcpServers = enabledMcpServersRef.current
+          const customMcpServers = enabledCustomServersRef.current
+
+          return {
+            api: `${agentUrlRef.current}/graph/${codeIdRef.current}/run`,
+            body: {
+              provider: provider?.type,
+              providerType: provider?.type,
+              providerName: provider?.name,
+              model: provider?.modelId ?? 'browseros',
+              contextWindowSize: provider?.contextWindow,
+              temperature: provider?.temperature,
+              resourceName: provider?.resourceName,
+              // Bedrock-specific
+              accessKeyId: provider?.accessKeyId,
+              secretAccessKey: provider?.secretAccessKey,
+              region: provider?.region,
+              sessionToken: provider?.sessionToken,
+              apiKey: provider?.apiKey,
+              baseUrl: provider?.baseUrl,
+              browserContext: {
+                windowId: metadata?.window?.id,
+                activeTab: metadata?.window?.tabs?.[0],
+                enabledMcpServers: compact(enabledMcpServers),
+                customMcpServers,
+              },
+              userSystemPrompt: personalizationRef.current,
+            },
+          }
+        }
+
+        return {
+          api: `${agentUrlRef.current}/graph`,
+          body: {
+            query: lastMessageText,
+          },
+        }
+      },
+    }),
+  })
+
+  const lastAssistantMessageWithGraph = messages.findLast((m) => {
+    if (m.role !== 'assistant') return false
+    const metadata = m.metadata as GraphMessageMetadata | undefined
+    return metadata?.graph !== undefined
+  })
+
+  const onClickTest = async () => {
+    let backgroundWindow: chrome.windows.Window | undefined
+    try {
+      backgroundWindow = await chrome.windows.create({
+        url: 'chrome://newtab',
+        focused: true,
+        type: 'normal',
+      })
+    } catch {
+      // Fallback when no window context is available (e.g. all windows closed)
+      const tab = await chrome.tabs.create({
+        url: 'chrome://newtab',
+        active: true,
+      })
+      if (tab.windowId) {
+        backgroundWindow = await chrome.windows.get(tab.windowId)
+      }
+    }
+
+    sendMessage({
+      text: 'Run a test of the graph you just created.',
+      metadata: {
+        messageType: 'run-graph' as MessageType,
+        codeId,
+        window: backgroundWindow,
+      },
+    })
+  }
+
+  const hasUnsavedChanges = savedWorkflowId ? codeId !== savedCodeId : true
+  const shouldBlockNavigation = !!codeId && hasUnsavedChanges
+
+  // Handle browser refresh/close
+  useEffect(() => {
+    const handleBeforeUnload = (e: BeforeUnloadEvent) => {
+      if (shouldBlockNavigation) {
+        e.preventDefault()
+      }
+    }
+
+    window.addEventListener('beforeunload', handleBeforeUnload)
+    return () => window.removeEventListener('beforeunload', handleBeforeUnload)
+  }, [shouldBlockNavigation])
+
+  const onClickSave = async () => {
+    if (!graphName || !codeId) return
+
+    if (savedWorkflowId) {
+      await editWorkflow(savedWorkflowId, {
+        workflowName: graphName,
+        codeId,
+      })
+      setSavedCodeId(codeId)
+    } else {
+      const newWorkflow = await addWorkflow({
+        workflowName: graphName,
+        codeId,
+      })
+      setSavedWorkflowId(newWorkflow.id)
+      setSavedCodeId(codeId)
+    }
+    track(GRAPH_SAVED_EVENT)
+  }
+
+  // Provider data for header
+  const providers: Provider[] = llmProviders.map((p) => ({
+    id: p.id,
+    name: p.name,
+    type: p.type,
+  }))
+
+  const selectedProviderForHeader: Provider | undefined = selectedLlmProvider
+    ? {
+        id: selectedLlmProvider.id,
+        name: selectedLlmProvider.name,
+        type: selectedLlmProvider.type,
+      }
+    : providers[0]
+
+  // Has generated code but can't auto-save (no name)
+  const hasUnsavedWork = codeId && !graphName
+
+  const resetToNewWorkflow = () => {
+    setCodeId(undefined)
+    setGraphData(undefined)
+    setGraphName('')
+    setSavedWorkflowId(undefined)
+    setSavedCodeId(undefined)
+    setMessages([])
+  }
+
+  const handleSelectProvider = (provider: Provider) => {
+    setDefaultProvider(provider.id)
+  }
+
+  const handleNewWorkflow = async () => {
+    // Can auto-save: has name AND code
+    if (graphName && codeId) {
+      await onClickSave()
+      resetToNewWorkflow()
+      return
+    }
+
+    // Has unsaved work that can't be auto-saved: show confirmation
+    if (hasUnsavedWork) {
+      setShowDiscardDialog(true)
+      return
+    }
+
+    // Nothing to save, just reset
+    resetToNewWorkflow()
+  }
+
+  const handleConfirmDiscard = () => {
+    setShowDiscardDialog(false)
+    resetToNewWorkflow()
+  }
+
+  const handleSuggestionClick = (prompt: string) => {
+    sendMessage({
+      text: prompt,
+      metadata: {
+        messageType: 'create-graph' as MessageType,
+      },
+    })
+  }
+
+  useDeepCompareEffect(() => {
+    if (status === 'ready' && lastAssistantMessageWithGraph) {
+      const metadata = lastAssistantMessageWithGraph.metadata as
+        | GraphMessageMetadata
+        | undefined
+      setCodeId(metadata?.codeId)
+      setGraphData(metadata?.graph)
+    }
+  }, [status, lastAssistantMessageWithGraph ?? {}])
+
+  if (!isInitialized || isLoadingProviders || !selectedProviderForHeader) {
+    return (
+      <div className="flex h-screen w-screen items-center justify-center bg-background text-foreground">
+        <div className="fade-in animate-in text-muted-foreground duration-200 [animation-delay:300ms] [animation-fill-mode:backwards]">
+          Loading...
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div className="h-screen w-screen bg-background text-foreground">
+      <ResizablePanelGroup orientation="horizontal">
+        <ResizablePanel
+          id="graph-canvas"
+          defaultSize={'70%'}
+          minSize={'30%'}
+          maxSize={'70%'}
+          onResize={(size) => setCanvasPanelSize(size)}
+        >
+          <GraphCanvas
+            graphName={graphName}
+            onGraphNameChange={(val) => setGraphName(val)}
+            graphData={graphData}
+            codeId={codeId}
+            onClickTest={onClickTest}
+            onClickSave={onClickSave}
+            isSaved={!!savedWorkflowId}
+            hasUnsavedChanges={hasUnsavedChanges}
+            shouldBlockNavigation={shouldBlockNavigation}
+            panelSize={canvasPanelSize}
+          />
+        </ResizablePanel>
+
+        <ResizableHandle withHandle />
+
+        <ResizablePanel
+          id="graph-chat"
+          defaultSize={'30%'}
+          maxSize={'70%'}
+          minSize={'30%'}
+        >
+          <div className="flex h-full flex-col">
+            <WorkflowsChatHeader
+              selectedProvider={selectedProviderForHeader}
+              providers={providers}
+              onSelectProvider={handleSelectProvider}
+              onNewWorkflow={handleNewWorkflow}
+              hasMessages={messages.length > 0}
+            />
+            <div className="min-h-0 flex-1">
+              <GraphChat
+                messages={messages}
+                onSubmit={onSubmit}
+                onInputChange={updateQuery}
+                onStop={stop}
+                input={query}
+                status={status}
+                agentUrlError={agentUrlError}
+                chatError={error}
+                onSuggestionClick={handleSuggestionClick}
+              />
+            </div>
+          </div>
+        </ResizablePanel>
+      </ResizablePanelGroup>
+
+      <AlertDialog open={showDiscardDialog} onOpenChange={setShowDiscardDialog}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>Discard unsaved workflow?</AlertDialogTitle>
+            <AlertDialogDescription>
+              You have an unsaved workflow. Creating a new one will discard your
+              current changes.
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogAction onClick={handleConfirmDiscard}>
+              Discard
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/CreateGraphWrapper.tsx

@@ -0,0 +1,13 @@
+import { type FC, Suspense } from 'react'
+import { RpcClientProvider } from '@/lib/rpc/RpcClientProvider'
+import { CreateGraph } from './CreateGraph'
+
+export const CreateGraphWrapper: FC = () => {
+  return (
+    <RpcClientProvider>
+      <Suspense fallback={<div className="h-screen w-screen bg-background" />}>
+        <CreateGraph />
+      </Suspense>
+    </RpcClientProvider>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/CustomNode.tsx

@@ -0,0 +1,140 @@
+import { Handle, type Node, type NodeProps, Position } from '@xyflow/react'
+import {
+  CheckCircle,
+  Download,
+  GitBranch,
+  GitMerge,
+  MousePointer,
+  Navigation,
+  Play,
+  RotateCw,
+  Split,
+  Square,
+} from 'lucide-react'
+import type React from 'react'
+import { memo } from 'react'
+import { cn } from '@/lib/utils'
+
+const nodeConfig: Record<
+  NodeType,
+  { color: string; icon: React.ElementType; label: string }
+> = {
+  start: {
+    color: 'text-green-600 dark:text-green-400',
+    icon: Play,
+    label: 'Start',
+  },
+  end: {
+    color: 'text-red-600 dark:text-red-400',
+    icon: Square,
+    label: 'End',
+  },
+  nav: {
+    color: 'text-blue-600 dark:text-blue-400',
+    icon: Navigation,
+    label: 'Navigate',
+  },
+  act: {
+    color: 'text-purple-600 dark:text-purple-400',
+    icon: MousePointer,
+    label: 'Action',
+  },
+  extract: {
+    color: 'text-amber-600 dark:text-amber-400',
+    icon: Download,
+    label: 'Extract',
+  },
+  verify: {
+    color: 'text-emerald-600 dark:text-emerald-400',
+    icon: CheckCircle,
+    label: 'Verify',
+  },
+  decision: {
+    color: 'text-pink-600 dark:text-pink-400',
+    icon: GitBranch,
+    label: 'Decision',
+  },
+  loop: {
+    color: 'text-cyan-600 dark:text-cyan-400',
+    icon: RotateCw,
+    label: 'Loop',
+  },
+  fork: {
+    color: 'text-indigo-600 dark:text-indigo-400',
+    icon: Split,
+    label: 'Fork',
+  },
+  join: {
+    color: 'text-lime-600 dark:text-lime-400',
+    icon: GitMerge,
+    label: 'Join',
+  },
+}
+
+export type NodeType =
+  | 'start'
+  | 'end'
+  | 'nav'
+  | 'act'
+  | 'extract'
+  | 'verify'
+  | 'decision'
+  | 'loop'
+  | 'fork'
+  | 'join'
+
+type CustomNodeData = Node<{
+  type: NodeType
+  label: string
+}>
+
+export const CustomNode = memo(
+  ({ data: { label, type } }: NodeProps<CustomNodeData>) => {
+    const config = nodeConfig[type || 'start']
+    const Icon = config.icon
+
+    const showSourceHandle = type !== 'end'
+    const showTargetHandle = type !== 'start'
+
+    return (
+      <div className="min-w-45 rounded-lg border border-border bg-card px-4 py-3 shadow-md transition-all">
+        {showTargetHandle && (
+          <Handle
+            type="target"
+            position={Position.Top}
+            className="h-2 w-2 bg-accent-orange!"
+          />
+        )}
+
+        <div className="flex items-center gap-2">
+          <div className={cn('shrink-0', config.color)}>
+            <Icon className="h-5 w-5" />
+          </div>
+          <div className="min-w-0 flex-1">
+            <div
+              className={cn(
+                'mb-0.5 font-semibold text-xs uppercase tracking-wide',
+                config.color,
+              )}
+            >
+              {config.label}
+            </div>
+            <div className="wrap-break-word font-medium text-foreground text-sm">
+              {label}
+            </div>
+          </div>
+        </div>
+
+        {showSourceHandle && (
+          <Handle
+            type="source"
+            position={Position.Bottom}
+            className="h-2 w-2 bg-accent-orange!"
+          />
+        )}
+      </div>
+    )
+  },
+)
+
+CustomNode.displayName = 'CustomNode'

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/GraphCanvas.tsx

@@ -0,0 +1,514 @@
+import cytoscape from 'cytoscape'
+import dagre from 'cytoscape-dagre'
+// @ts-expect-error no types available
+import nodeHtmlLabel from 'cytoscape-node-html-label'
+import DOMPurify from 'dompurify'
+import {
+  ArrowLeft,
+  Maximize,
+  Minus,
+  Pencil,
+  Play,
+  Plus,
+  Save,
+} from 'lucide-react'
+import type { FC } from 'react'
+import { useCallback, useEffect, useRef, useState } from 'react'
+import { useNavigate } from 'react-router'
+import useDeepCompareEffect from 'use-deep-compare-effect'
+import ProductLogo from '@/assets/product_logo.svg'
+import { Button } from '@/components/ui/button'
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from '@/components/ui/tooltip'
+import type { GraphData } from './CreateGraph'
+import type { NodeType } from './CustomNode'
+
+cytoscape.use(dagre)
+nodeHtmlLabel(cytoscape)
+
+const NODE_CONFIG: Record<
+  NodeType,
+  { color: string; bgColor: string; icon: string; label: string }
+> = {
+  start: {
+    color: '#22c55e',
+    bgColor: 'rgba(34, 197, 94, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="6 3 20 12 6 21 6 3"></polygon></svg>`,
+    label: 'START',
+  },
+  end: {
+    color: '#ef4444',
+    bgColor: 'rgba(239, 68, 68, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="18" x="3" y="3" rx="2"></rect></svg>`,
+    label: 'END',
+  },
+  nav: {
+    color: '#3b82f6',
+    bgColor: 'rgba(59, 130, 246, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="3 11 22 2 13 21 11 13 3 11"></polygon></svg>`,
+    label: 'NAVIGATE',
+  },
+  act: {
+    color: '#8b5cf6',
+    bgColor: 'rgba(139, 92, 246, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m4 4 7.07 17 2.51-7.39L21 11.07z"></path></svg>`,
+    label: 'ACTION',
+  },
+  extract: {
+    color: '#f59e0b',
+    bgColor: 'rgba(245, 158, 11, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="7 10 12 15 17 10"></polyline><line x1="12" x2="12" y1="15" y2="3"></line></svg>`,
+    label: 'EXTRACT',
+  },
+  verify: {
+    color: '#10b981',
+    bgColor: 'rgba(16, 185, 129, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"></path><polyline points="22 4 12 14.01 9 11.01"></polyline></svg>`,
+    label: 'VERIFY',
+  },
+  decision: {
+    color: '#ec4899',
+    bgColor: 'rgba(236, 72, 153, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="6" x2="6" y1="3" y2="15"></line><circle cx="18" cy="6" r="3"></circle><circle cx="6" cy="18" r="3"></circle><path d="M18 9a9 9 0 0 1-9 9"></path></svg>`,
+    label: 'DECISION',
+  },
+  loop: {
+    color: '#06b6d4',
+    bgColor: 'rgba(6, 182, 212, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12a9 9 0 1 1-9-9c2.52 0 4.93 1 6.74 2.74L21 8"></path><path d="M21 3v5h-5"></path></svg>`,
+    label: 'LOOP',
+  },
+  fork: {
+    color: '#6366f1',
+    bgColor: 'rgba(99, 102, 241, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M16 3h5v5"></path><path d="M8 3H3v5"></path><path d="M12 22v-8.3a4 4 0 0 0-1.172-2.872L3 3"></path><path d="m15 9 6-6"></path></svg>`,
+    label: 'FORK',
+  },
+  join: {
+    color: '#84cc16',
+    bgColor: 'rgba(132, 204, 22, 0.1)',
+    icon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="18" cy="18" r="3"></circle><circle cx="6" cy="6" r="3"></circle><path d="M6 21V9a9 9 0 0 0 9 9"></path></svg>`,
+    label: 'JOIN',
+  },
+}
+
+const initialData: GraphData = {
+  nodes: [
+    {
+      id: 'start',
+      type: 'start',
+      data: { label: 'Use the Chat to build your workflow!' },
+    },
+  ],
+  edges: [],
+}
+
+const MIN_NODE_WIDTH = 180
+const MAX_NODE_WIDTH = 240
+const BASE_NODE_HEIGHT = 70
+const CHAR_WIDTH = 7
+const ICON_AND_PADDING = 62
+const MAX_ZOOM = 1.2
+
+const calculateNodeDimensions = (
+  label: string,
+): { width: number; height: number } => {
+  const textWidth = label.length * CHAR_WIDTH + ICON_AND_PADDING
+  const width = Math.max(MIN_NODE_WIDTH, Math.min(MAX_NODE_WIDTH, textWidth))
+
+  const maxCharsPerLine = Math.floor((width - ICON_AND_PADDING) / CHAR_WIDTH)
+  const lines = Math.ceil(label.length / maxCharsPerLine)
+  const extraHeight = Math.max(0, lines - 1) * 18
+  const height = BASE_NODE_HEIGHT + extraHeight
+
+  return { width, height }
+}
+
+const createNodeHtml = (type: NodeType, label: string): string => {
+  const config = NODE_CONFIG[type] || NODE_CONFIG.start
+  const sanitizedLabel = DOMPurify.sanitize(label, { ALLOWED_TAGS: [] })
+  return `
+    <div class="graph-node" style="
+      display: flex;
+      align-items: flex-start;
+      gap: 10px;
+      min-width: 160px;
+      max-width: 220px;
+      padding: 12px 16px;
+      background-color: var(--graph-node-bg);
+      border: 1px solid var(--graph-node-border);
+      border-radius: 10px;
+      box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+      font-family: system-ui, -apple-system, sans-serif;
+    ">
+      <div style="
+        flex-shrink: 0;
+        color: ${config.color};
+        margin-top: 2px;
+      ">
+        ${config.icon}
+      </div>
+      <div style="flex: 1; min-width: 0;">
+        <div style="
+          font-size: 10px;
+          font-weight: 600;
+          letter-spacing: 0.05em;
+          color: ${config.color};
+          margin-bottom: 4px;
+        ">${config.label}</div>
+        <div style="
+          font-size: 13px;
+          font-weight: 500;
+          color: var(--graph-node-text);
+          line-height: 1.4;
+          word-wrap: break-word;
+        ">${sanitizedLabel}</div>
+      </div>
+    </div>
+  `
+}
+
+type GraphCanvasProps = {
+  graphName: string
+  onGraphNameChange: (name: string) => void
+  graphData?: GraphData
+  codeId?: string
+  onClickTest: () => unknown
+  onClickSave: () => unknown
+  isSaved: boolean
+  hasUnsavedChanges: boolean
+  shouldBlockNavigation: boolean
+  panelSize?: { asPercentage: number; inPixels: number }
+}
+
+export const GraphCanvas: FC<GraphCanvasProps> = ({
+  graphName,
+  onGraphNameChange,
+  graphData = initialData,
+  codeId,
+  onClickTest,
+  onClickSave,
+  isSaved,
+  hasUnsavedChanges,
+  shouldBlockNavigation,
+  panelSize,
+}) => {
+  const [isEditingName, setIsEditingName] = useState(false)
+  const navigate = useNavigate()
+  const containerRef = useRef<HTMLDivElement>(null)
+  const cyRef = useRef<cytoscape.Core | null>(null)
+
+  const handleBack = () => {
+    if (shouldBlockNavigation) {
+      const confirmed = window.confirm(
+        'You have unsaved changes. Are you sure you want to leave?',
+      )
+      if (!confirmed) return
+    }
+    navigate(-1)
+  }
+
+  const canTest = !!codeId
+  const canSave = !!graphName && !!codeId && hasUnsavedChanges
+
+  const getTestTooltip = () => {
+    if (!codeId) return 'Create a workflow using the chat first'
+    return 'Run a test of this workflow'
+  }
+
+  const getSaveTooltip = () => {
+    if (!codeId) return 'Create a workflow using the chat first'
+    if (!graphName) return 'Provide a name for the workflow'
+    if (isSaved && !hasUnsavedChanges) return 'Workflow already saved'
+    return isSaved ? 'Save changes to this workflow' : 'Save this workflow'
+  }
+
+  const getSaveButtonLabel = () => {
+    return isSaved ? 'Save Changes' : 'Save Workflow'
+  }
+
+  const zoomIn = useCallback(() => {
+    cyRef.current?.zoom(cyRef.current.zoom() * 1.2)
+    cyRef.current?.center()
+  }, [])
+
+  const zoomOut = useCallback(() => {
+    cyRef.current?.zoom(cyRef.current.zoom() / 1.2)
+    cyRef.current?.center()
+  }, [])
+
+  const fitView = useCallback(() => {
+    cyRef.current?.fit(undefined, 50)
+    cyRef.current?.center()
+  }, [])
+
+  useEffect(() => {
+    if (!containerRef.current) return
+
+    const cy = cytoscape({
+      container: containerRef.current,
+      elements: [],
+      style: [
+        {
+          selector: 'node',
+          style: {
+            width: 'data(nodeWidth)',
+            height: 'data(nodeHeight)',
+            'background-opacity': 0,
+            'border-width': 0,
+          },
+        },
+        {
+          selector: 'edge',
+          style: {
+            width: 2,
+            'line-color': '#f97316',
+            'target-arrow-color': '#f97316',
+            'target-arrow-shape': 'triangle',
+            'curve-style': 'bezier',
+            'arrow-scale': 1.2,
+          },
+        },
+        {
+          selector: 'edge.back-edge',
+          style: {
+            'line-style': 'dashed',
+            'line-dash-pattern': [6, 3],
+            'curve-style': 'unbundled-bezier',
+            'control-point-distances': [100],
+            'control-point-weights': [0.5],
+          },
+        },
+      ],
+      layout: { name: 'preset' },
+      userZoomingEnabled: true,
+      userPanningEnabled: true,
+      boxSelectionEnabled: false,
+      selectionType: 'single',
+      autoungrabify: true,
+      autounselectify: true,
+      maxZoom: MAX_ZOOM,
+      minZoom: 0.2,
+    })
+
+    // @ts-expect-error nodeHtmlLabel extension
+    cy.nodeHtmlLabel([
+      {
+        query: 'node',
+        halign: 'center',
+        valign: 'center',
+        halignBox: 'center',
+        valignBox: 'center',
+        tpl: (data: { type: NodeType; label: string }) => {
+          return createNodeHtml(data.type, data.label)
+        },
+      },
+    ])
+
+    cyRef.current = cy
+
+    return () => {
+      cy.destroy()
+    }
+  }, [])
+
+  const updateGraph = useCallback((data: GraphData) => {
+    const cy = cyRef.current
+    if (!cy) return
+
+    cy.elements().remove()
+
+    const nodes = data.nodes.map((node) => {
+      const dimensions = calculateNodeDimensions(node.data.label)
+      return {
+        data: {
+          id: node.id,
+          label: node.data.label,
+          type: node.type as NodeType,
+          nodeWidth: dimensions.width,
+          nodeHeight: dimensions.height,
+        },
+      }
+    })
+
+    const edges = data.edges.map((edge) => ({
+      data: {
+        id: edge.id,
+        source: edge.source,
+        target: edge.target,
+      },
+    }))
+
+    cy.add([...nodes, ...edges])
+
+    cy.layout({
+      name: 'dagre',
+      rankDir: 'TB',
+      nodeSep: 80,
+      rankSep: 100,
+      padding: 50,
+      animate: true,
+      animationDuration: 300,
+      fit: true,
+    } as cytoscape.LayoutOptions).run()
+
+    setTimeout(() => {
+      cy.edges().forEach((edge) => {
+        const sourceNode = edge.source()
+        const targetNode = edge.target()
+        const sourceY = sourceNode.position('y')
+        const targetY = targetNode.position('y')
+
+        if (sourceY > targetY) {
+          edge.addClass('back-edge')
+        }
+      })
+    }, 350)
+  }, [])
+
+  useDeepCompareEffect(() => {
+    updateGraph(graphData)
+  }, [graphData])
+
+  useEffect(() => {
+    if (panelSize?.inPixels !== undefined) {
+      cyRef.current?.resize()
+      setTimeout(() => fitView(), 100)
+    }
+  }, [panelSize?.inPixels, fitView])
+
+  return (
+    <div className="flex h-full flex-col [--graph-node-bg:rgba(255,255,255,1)] [--graph-node-border:rgba(228,228,231,1)] [--graph-node-text:rgba(24,24,27,1)] dark:[--graph-node-bg:rgba(24,24,27,1)] dark:[--graph-node-border:rgba(63,63,70,1)] dark:[--graph-node-text:rgba(250,250,250,1)]">
+      {/* Graph Header */}
+      <header className="flex h-14 shrink-0 items-center justify-between border-border/40 border-b bg-background/80 px-3 backdrop-blur-md">
+        <div className="flex min-w-0 flex-1 items-center gap-3">
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-8 w-8 shrink-0"
+            onClick={handleBack}
+          >
+            <ArrowLeft className="h-4 w-4" />
+          </Button>
+          <img src={ProductLogo} alt="BrowserOS" className="h-8 w-8 shrink-0" />
+          {isEditingName ? (
+            <input
+              type="text"
+              value={graphName}
+              onChange={(e) => onGraphNameChange(e.target.value)}
+              onBlur={() => setIsEditingName(false)}
+              onKeyDown={(e) => {
+                if (e.key === 'Enter') setIsEditingName(false)
+              }}
+              // biome-ignore lint/a11y/noAutofocus: needed to autofocus field when edit mode is toggled
+              autoFocus
+              placeholder="Enter workflow name..."
+              className="max-w-64 border-[var(--accent-orange)] border-b bg-transparent font-semibold text-sm outline-none placeholder:font-normal placeholder:text-muted-foreground/60"
+            />
+          ) : (
+            <Button
+              variant="ghost"
+              size="sm"
+              onClick={() => setIsEditingName(true)}
+              className="group min-w-0 gap-2 px-2 py-1"
+            >
+              {graphName ? (
+                <span className="truncate font-semibold text-sm">
+                  {graphName}
+                </span>
+              ) : (
+                <span className="text-muted-foreground/60 text-sm italic">
+                  Untitled workflow
+                </span>
+              )}
+              <Pencil className="h-3.5 w-3.5 shrink-0 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100" />
+            </Button>
+          )}
+        </div>
+
+        {/* Control Buttons */}
+        <div className="flex items-center gap-2">
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <span>
+                <Button
+                  variant="secondary"
+                  size="sm"
+                  onClick={onClickTest}
+                  disabled={!canTest}
+                >
+                  <Play className="mr-1.5 h-4 w-4" />
+                  Test Workflow
+                </Button>
+              </span>
+            </TooltipTrigger>
+            <TooltipContent>{getTestTooltip()}</TooltipContent>
+          </Tooltip>
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <span>
+                <Button
+                  size="sm"
+                  onClick={onClickSave}
+                  disabled={!canSave}
+                  className="bg-[var(--accent-orange)] shadow-lg shadow-orange-500/20 hover:bg-[var(--accent-orange-bright)] disabled:bg-[var(--accent-orange)]/50"
+                >
+                  <Save className="mr-1.5 h-4 w-4" />
+                  {getSaveButtonLabel()}
+                </Button>
+              </span>
+            </TooltipTrigger>
+            <TooltipContent>{getSaveTooltip()}</TooltipContent>
+          </Tooltip>
+        </div>
+      </header>
+
+      {/* Graph Canvas */}
+      <div className="relative min-h-0 flex-1 overflow-hidden [--dot-color:rgba(0,0,0,0.2)] dark:[--dot-color:rgba(255,255,255,0.15)]">
+        <div
+          ref={containerRef}
+          className="h-full w-full bg-zinc-50 dark:bg-zinc-900"
+          style={{
+            backgroundImage:
+              'radial-gradient(circle, var(--dot-color) 1.5px, transparent 1.5px)',
+            backgroundSize: '20px 20px',
+          }}
+        />
+
+        {/* Zoom Controls */}
+        <div className="absolute bottom-4 left-4 z-10 flex flex-col gap-1 rounded-lg border-2 border-border bg-card p-1">
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-8 w-8"
+            onClick={zoomIn}
+            title="Zoom in"
+          >
+            <Plus className="h-4 w-4" />
+          </Button>
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-8 w-8"
+            onClick={zoomOut}
+            title="Zoom out"
+          >
+            <Minus className="h-4 w-4" />
+          </Button>
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-8 w-8"
+            onClick={fitView}
+            title="Fit view"
+          >
+            <Maximize className="h-4 w-4" />
+          </Button>
+        </div>
+      </div>
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/GraphChat.tsx

@@ -0,0 +1,194 @@
+import type { UIMessage } from 'ai'
+import { Send, SquareStop } from 'lucide-react'
+import type { FC, FormEventHandler, KeyboardEvent } from 'react'
+import { useEffect, useRef, useState } from 'react'
+import { ChatError } from '@/entrypoints/sidepanel/index/ChatError'
+import { ChatMessages } from '@/entrypoints/sidepanel/index/ChatMessages'
+import { getResponseAndQueryFromMessageId } from '@/entrypoints/sidepanel/index/useChatSession'
+import {
+  GRAPH_MESSAGE_DISLIKE_EVENT,
+  GRAPH_MESSAGE_LIKE_EVENT,
+} from '@/lib/constants/analyticsEvents'
+import { useJtbdPopup } from '@/lib/jtbd-popup/useJtbdPopup'
+import { track } from '@/lib/metrics/track'
+import { cn } from '@/lib/utils'
+import { GraphEmptyState } from './GraphEmptyState'
+import { getWorkflowDisplayMessages } from './workflow-tidbit-messages'
+
+interface GraphChatProps {
+  onSubmit: FormEventHandler<HTMLFormElement>
+  onInputChange: (value: string) => void
+  onStop: () => void
+  input: string
+  status: 'streaming' | 'submitted' | 'ready' | 'error'
+  messages: UIMessage[]
+  chatError?: Error
+  agentUrlError?: Error | null
+  onSuggestionClick: (prompt: string) => void
+}
+
+export const GraphChat: FC<GraphChatProps> = ({
+  onSubmit,
+  onInputChange,
+  onStop,
+  input,
+  status,
+  messages,
+  chatError,
+  agentUrlError,
+  onSuggestionClick,
+}) => {
+  const [liked, setLiked] = useState<Record<string, boolean>>({})
+  const [disliked, setDisliked] = useState<Record<string, boolean>>({})
+  const [mounted, setMounted] = useState(false)
+  const displayMessages = getWorkflowDisplayMessages(messages)
+
+  useEffect(() => {
+    setMounted(true)
+  }, [])
+
+  const {
+    popupVisible,
+    recordMessageSent,
+    triggerIfEligible,
+    onTakeSurvey: onTakeSurveyBase,
+    onDismiss: onDismissJtbdPopup,
+  } = useJtbdPopup()
+
+  const onTakeSurvey = () =>
+    onTakeSurveyBase({ experimentId: 'workflow_survey' })
+
+  // Trigger JTBD popup when AI finishes responding
+  const previousChatStatus = useRef(status)
+  // biome-ignore lint/correctness/useExhaustiveDependencies: intentionally only trigger on status change
+  useEffect(() => {
+    const aiWasProcessing =
+      previousChatStatus.current === 'streaming' ||
+      previousChatStatus.current === 'submitted'
+    const aiJustFinished = aiWasProcessing && status === 'ready'
+
+    if (aiJustFinished && messages.length > 0) {
+      triggerIfEligible()
+    }
+    previousChatStatus.current = status
+  }, [status])
+
+  const onClickLike = (messageId: string) => {
+    const { responseText, queryText } = getResponseAndQueryFromMessageId(
+      messages,
+      messageId,
+    )
+
+    track(GRAPH_MESSAGE_LIKE_EVENT, { responseText, queryText, messageId })
+
+    setLiked((prev) => ({
+      ...prev,
+      [messageId]: !prev[messageId],
+    }))
+  }
+
+  const onClickDislike = (messageId: string, comment?: string) => {
+    const { responseText, queryText } = getResponseAndQueryFromMessageId(
+      messages,
+      messageId,
+    )
+
+    track(GRAPH_MESSAGE_DISLIKE_EVENT, {
+      responseText,
+      queryText,
+      messageId,
+      comment,
+    })
+
+    setDisliked((prev) => ({
+      ...prev,
+      [messageId]: !prev[messageId],
+    }))
+  }
+
+  const handleSubmit: FormEventHandler<HTMLFormElement> = (e) => {
+    recordMessageSent()
+    onSubmit(e)
+  }
+
+  const handleKeyDown = (e: KeyboardEvent<HTMLTextAreaElement>) => {
+    if (
+      e.key === 'Enter' &&
+      !e.shiftKey &&
+      !e.metaKey &&
+      !e.ctrlKey &&
+      !e.nativeEvent.isComposing
+    ) {
+      e.preventDefault()
+      if (input.trim()) {
+        e.currentTarget.form?.requestSubmit()
+      }
+    }
+  }
+
+  return (
+    <div className="flex h-full flex-col overflow-hidden">
+      <div className="styled-scrollbar min-h-0 flex-1 overflow-y-auto pb-2">
+        {displayMessages.length === 0 ? (
+          <GraphEmptyState
+            mounted={mounted}
+            onSuggestionClick={onSuggestionClick}
+          />
+        ) : (
+          <ChatMessages
+            liked={liked}
+            disliked={disliked}
+            onClickDislike={onClickDislike}
+            onClickLike={onClickLike}
+            messages={displayMessages}
+            status={status}
+            showJtbdPopup={popupVisible}
+            showDontShowAgain={false}
+            onTakeSurvey={onTakeSurvey}
+            onDismissJtbdPopup={onDismissJtbdPopup}
+          />
+        )}
+      </div>
+      {agentUrlError && <ChatError error={agentUrlError} />}
+      {chatError && <ChatError error={chatError} />}
+      <div className="shrink-0 border-border/40 border-t bg-background/80 p-2 backdrop-blur-md">
+        <form
+          onSubmit={handleSubmit}
+          className="relative flex w-full items-end gap-2"
+        >
+          <textarea
+            className={cn(
+              'field-sizing-content max-h-60 min-h-[42px] flex-1 resize-none overflow-hidden rounded-2xl border border-border/50 bg-muted/50 px-4 py-2.5 pr-11 text-sm outline-none transition-colors placeholder:text-muted-foreground/70 hover:border-border focus:border-[var(--accent-orange)]',
+            )}
+            value={input}
+            onChange={(e) => onInputChange(e.target.value)}
+            onKeyDown={handleKeyDown}
+            placeholder={
+              'Visit Amazon and add sensodyne toothpaste to the cart.'
+            }
+            rows={1}
+          />
+          {status === 'streaming' ? (
+            <button
+              type="button"
+              onClick={onStop}
+              className="absolute right-1.5 bottom-1.5 cursor-pointer rounded-full bg-red-600 p-2 text-white shadow-sm transition-all duration-200 hover:bg-red-900 disabled:cursor-not-allowed disabled:opacity-50"
+            >
+              <SquareStop className="h-3.5 w-3.5" />
+              <span className="sr-only">Stop</span>
+            </button>
+          ) : (
+            <button
+              type="submit"
+              disabled={!input.trim()}
+              className="absolute right-1.5 bottom-1.5 cursor-pointer rounded-full bg-[var(--accent-orange)] p-2 text-white shadow-sm transition-all duration-200 hover:bg-[var(--accent-orange-bright)] disabled:cursor-not-allowed disabled:opacity-50"
+            >
+              <Send className="h-3.5 w-3.5" />
+              <span className="sr-only">Send</span>
+            </button>
+          )}
+        </form>
+      </div>
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/GraphEmptyState.tsx

@@ -0,0 +1,77 @@
+import { Workflow } from 'lucide-react'
+import type { FC } from 'react'
+import { cn } from '@/lib/utils'
+
+interface Suggestion {
+  display: string
+  prompt: string
+  icon: string
+}
+
+const WORKFLOW_SUGGESTIONS: Suggestion[] = [
+  {
+    display: 'Search Amazon and add toothpaste to cart',
+    prompt:
+      'Go to Amazon, search for toothpaste, select 1 pack filter and add the first result to cart',
+    icon: '🛒',
+  },
+  {
+    display: 'Accept LinkedIn connection requests',
+    prompt:
+      'Open LinkedIn and go to my connection requests, accept one by one in a loop for 25 times',
+    icon: '🤝',
+  },
+  {
+    display: 'Unsubscribe from Gmail subscriptions',
+    prompt:
+      'Go to Gmail, navigate to manage subscriptions and unsubscribe from all',
+    icon: '📧',
+  },
+]
+
+interface GraphEmptyStateProps {
+  mounted: boolean
+  onSuggestionClick: (prompt: string) => void
+}
+
+export const GraphEmptyState: FC<GraphEmptyStateProps> = ({
+  mounted,
+  onSuggestionClick,
+}) => {
+  return (
+    <div
+      className={cn(
+        'm-0! flex h-full flex-col items-center justify-center space-y-4 text-center opacity-0 transition-all duration-700',
+        mounted ? 'translate-y-0 opacity-100' : 'translate-y-4 opacity-0',
+      )}
+    >
+      <div className="mb-2 flex h-14 w-14 items-center justify-center rounded-2xl bg-muted/50">
+        <Workflow className="h-7 w-7 text-[var(--accent-orange)]" />
+      </div>
+      <div>
+        <h2 className="mb-1 font-semibold text-lg">
+          Create reliable workflows
+        </h2>
+        <p className="max-w-[240px] text-muted-foreground text-xs">
+          Chat with the agent to create and refine browser automation
+        </p>
+      </div>
+
+      <div className="mt-6 grid w-full max-w-[300px] grid-cols-1 gap-2">
+        {WORKFLOW_SUGGESTIONS.map((suggestion) => (
+          <button
+            type="button"
+            key={suggestion.display}
+            onClick={() => onSuggestionClick(suggestion.prompt)}
+            className="group flex items-center justify-between rounded-lg border border-border/50 bg-card px-3 py-2.5 text-left text-xs transition-all duration-200 hover:border-[var(--accent-orange)]/50 hover:bg-[var(--accent-orange)]/5"
+          >
+            {suggestion.display}
+            <span className="opacity-0 transition-opacity duration-200 group-hover:opacity-100">
+              {suggestion.icon}
+            </span>
+          </button>
+        ))}
+      </div>
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/WorkflowsChatHeader.tsx

@@ -0,0 +1,92 @@
+import { Github, Plus, SettingsIcon } from 'lucide-react'
+import type { FC } from 'react'
+import { ChatProviderSelector } from '@/components/chat/ChatProviderSelector'
+import type { Provider } from '@/components/chat/chatComponentTypes'
+import { ThemeToggle } from '@/components/elements/theme-toggle'
+import { productRepositoryUrl } from '@/lib/constants/productUrls'
+import { BrowserOSIcon, ProviderIcon } from '@/lib/llm-providers/providerIcons'
+import type { ProviderType } from '@/lib/llm-providers/types'
+
+interface WorkflowsChatHeaderProps {
+  selectedProvider: Provider
+  providers: Provider[]
+  onSelectProvider: (provider: Provider) => void
+  onNewWorkflow: () => void
+  hasMessages: boolean
+}
+
+export const WorkflowsChatHeader: FC<WorkflowsChatHeaderProps> = ({
+  selectedProvider,
+  providers,
+  onSelectProvider,
+  onNewWorkflow,
+  hasMessages,
+}) => {
+  return (
+    <header className="flex h-14 shrink-0 items-center justify-between border-border/40 border-b bg-background/80 px-3 backdrop-blur-md">
+      <div className="flex items-center gap-2">
+        <ChatProviderSelector
+          providers={providers}
+          selectedProvider={selectedProvider}
+          onSelectProvider={onSelectProvider}
+        >
+          <button
+            type="button"
+            className="group relative inline-flex cursor-pointer items-center gap-2 rounded-lg p-2 text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground data-[state=open]:bg-accent"
+            title="Change AI Provider"
+          >
+            {selectedProvider.type === 'browseros' ? (
+              <BrowserOSIcon size={18} />
+            ) : (
+              <ProviderIcon
+                type={selectedProvider.type as ProviderType}
+                size={18}
+              />
+            )}
+            <span className="font-semibold text-base">
+              {selectedProvider.name}
+            </span>
+          </button>
+        </ChatProviderSelector>
+      </div>
+
+      <div className="flex items-center gap-1">
+        {hasMessages && (
+          <button
+            type="button"
+            onClick={onNewWorkflow}
+            className="cursor-pointer rounded-lg p-2 text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground"
+            title="New workflow"
+          >
+            <Plus className="h-4 w-4" />
+          </button>
+        )}
+
+        <a
+          href={productRepositoryUrl}
+          target="_blank"
+          rel="noopener noreferrer"
+          className="cursor-pointer rounded-lg p-2 text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground"
+          title="Star on Github"
+        >
+          <Github className="h-4 w-4" />
+        </a>
+
+        <a
+          href="/app.html#/settings"
+          target="_blank"
+          rel="noopener noreferrer"
+          className="cursor-pointer rounded-lg p-2 text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground"
+          title="Settings"
+        >
+          <SettingsIcon className="h-4 w-4" />
+        </a>
+
+        <ThemeToggle
+          className="rounded-lg p-2 text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground"
+          iconClassName="h-4 w-4"
+        />
+      </div>
+    </header>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/create-graph/workflow-tidbit-messages.ts

@@ -0,0 +1,111 @@
+import type { UIMessage } from 'ai'
+
+type MessagePart = UIMessage['parts'][number]
+
+const TIDBIT_SUFFIXES = ['...', '\u2026'] as const
+
+const isTextPart = (
+  part: MessagePart,
+): part is MessagePart & { type: 'text' } => part.type === 'text'
+
+const isTidbitLine = (line: string): boolean => {
+  const trimmed = line.trim()
+  if (trimmed.length === 0) return false
+  return TIDBIT_SUFFIXES.some((suffix) => trimmed.endsWith(suffix))
+}
+
+const getNonEmptyLines = (text: string): string[] =>
+  text.split('\n').filter((line) => line.trim().length > 0)
+
+const isAllTidbitText = (text: string): boolean => {
+  const lines = getNonEmptyLines(text)
+  return lines.length > 0 && lines.every((line) => isTidbitLine(line))
+}
+
+export const isWorkflowTidbitMessage = (message: UIMessage): boolean => {
+  if (message.role !== 'assistant') return false
+  if (message.parts.length === 0) return false
+  if (message.parts.some((part) => !isTextPart(part))) return false
+
+  const fullText = message.parts
+    .filter((part) => isTextPart(part))
+    .map((part) => part.text)
+    .join('')
+
+  return isAllTidbitText(fullText)
+}
+
+// within a text part that has multiple tidbit lines, keep only the last line
+const compactTidbitLinesInPart = (part: MessagePart): MessagePart => {
+  if (!isTextPart(part)) return part
+
+  const lines = getNonEmptyLines(part.text)
+  if (lines.length <= 1) return part
+  if (!lines.every((line) => isTidbitLine(line))) return part
+
+  return { ...part, text: lines[lines.length - 1] }
+}
+
+// collapse consecutive tidbit text parts within a single message
+const compactTidbitPartsInMessage = (message: UIMessage): UIMessage => {
+  if (message.role !== 'assistant') return message
+
+  // first compact multi-line tidbit text within each part
+  const lineCompactedParts = message.parts.map(compactTidbitLinesInPart)
+
+  // then collapse consecutive tidbit parts to just the last one
+  const compactedParts: UIMessage['parts'] = []
+  let pendingTidbitPart: (MessagePart & { type: 'text' }) | null = null
+
+  const flushPendingTidbitPart = () => {
+    if (!pendingTidbitPart) return
+    compactedParts.push(pendingTidbitPart)
+    pendingTidbitPart = null
+  }
+
+  for (const part of lineCompactedParts) {
+    if (isTextPart(part) && isAllTidbitText(part.text)) {
+      pendingTidbitPart = part
+      continue
+    }
+
+    flushPendingTidbitPart()
+    compactedParts.push(part)
+  }
+
+  flushPendingTidbitPart()
+
+  const partsChanged =
+    compactedParts.length !== message.parts.length ||
+    compactedParts.some((p, i) => p !== message.parts[i])
+
+  if (!partsChanged) return message
+
+  return { ...message, parts: compactedParts }
+}
+
+export const getWorkflowDisplayMessages = (
+  messages: UIMessage[],
+): UIMessage[] => {
+  // first compact tidbit parts within each message
+  const normalizedMessages = messages.map(compactTidbitPartsInMessage)
+  const compactedMessages: UIMessage[] = []
+
+  // then collapse consecutive tidbit-only messages
+  for (const message of normalizedMessages) {
+    const previousMessage = compactedMessages[compactedMessages.length - 1]
+    const shouldReplacePreviousTidbit =
+      previousMessage &&
+      isWorkflowTidbitMessage(previousMessage) &&
+      isWorkflowTidbitMessage(message)
+
+    if (shouldReplacePreviousTidbit) {
+      compactedMessages[compactedMessages.length - 1] = message
+      continue
+    }
+
+    compactedMessages.push(message)
+  }
+
+  return compactedMessages
+}

packages/browseros-agent/apps/agent/entrypoints/app/scheduled-tasks/ScheduledTasksList.tsx

@@ -28,7 +28,7 @@ export const ScheduledTasksList: FC<ScheduledTasksListProps> = ({
       <div className="rounded-xl border border-border bg-card p-6 shadow-sm">
         <div className="rounded-lg border border-border border-dashed py-8 text-center">
           <p className="text-muted-foreground text-sm">
-            No scheduled tasks yet. Create one to automate recurring tasks.
+            No scheduled tasks yet. Create one to automate recurring workflows.
           </p>
         </div>
       </div>

packages/browseros-agent/apps/agent/entrypoints/app/skills/SkillsPage.tsx

@@ -238,7 +238,7 @@ const EmptyState: FC<{ onCreateClick: () => void }> = ({ onCreateClick }) => (
       <h3 className="mb-1 font-medium text-lg">No skills yet</h3>
       <p className="mb-5 max-w-sm text-muted-foreground text-sm leading-6">
         Skills teach your agent how to handle repeatable tasks like research,
-        extraction, and repeatable browser tasks.
+        extraction, and structured workflows.
       </p>
       <Button onClick={onCreateClick} size="sm">
         <Plus className="mr-1.5 size-4" />

packages/browseros-agent/apps/agent/entrypoints/app/workflows/RunWorkflowDialog.tsx

@@ -0,0 +1,123 @@
+import type { UIMessage } from 'ai'
+import { Loader2, RotateCcw, Square, X } from 'lucide-react'
+import type { FC } from 'react'
+import { Button } from '@/components/ui/button'
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+} from '@/components/ui/dialog'
+
+interface RunWorkflowDialogProps {
+  open: boolean
+  workflowName: string
+  messages: UIMessage[]
+  status: 'streaming' | 'submitted' | 'ready' | 'error'
+  wasCancelled: boolean
+  error: Error | undefined
+  onStop: () => void
+  onRetry: () => void
+  onClose: () => void
+}
+
+export const RunWorkflowDialog: FC<RunWorkflowDialogProps> = ({
+  open,
+  workflowName,
+  messages,
+  status,
+  wasCancelled,
+  error,
+  onStop,
+  onRetry,
+  onClose,
+}) => {
+  const isProcessing = status === 'streaming' || status === 'submitted'
+  const _isComplete = !isProcessing
+
+  const getStatusText = () => {
+    if (status === 'submitted') return 'Starting workflow...'
+    if (status === 'streaming') return 'Running...'
+    if (wasCancelled) return 'Execution cancelled'
+    if (status === 'error') return 'Error occurred'
+    return 'Completed'
+  }
+
+  const getMessageContent = (message: UIMessage) => {
+    return message.parts
+      .filter((part) => part.type === 'text')
+      .map((part) => part.text)
+      .join('')
+  }
+
+  const assistantMessages = messages.filter((m) => m.role === 'assistant')
+
+  return (
+    <Dialog open={open} onOpenChange={() => {}}>
+      <DialogContent
+        className="max-h-[80vh] max-w-2xl overflow-hidden [&>button]:hidden"
+        onInteractOutside={(e) => e.preventDefault()}
+        onEscapeKeyDown={(e) => e.preventDefault()}
+      >
+        <DialogHeader className="flex-row items-center justify-between space-y-0">
+          <DialogTitle className="flex items-center gap-2">
+            {isProcessing && (
+              <Loader2 className="h-4 w-4 animate-spin text-[var(--accent-orange)]" />
+            )}
+            Running: {workflowName}
+          </DialogTitle>
+          <div className="flex items-center gap-2">
+            {isProcessing ? (
+              <Button variant="destructive" size="sm" onClick={onStop}>
+                <Square className="mr-1.5 h-3 w-3" />
+                Stop
+              </Button>
+            ) : (
+              <>
+                <Button variant="secondary" size="sm" onClick={onRetry}>
+                  <RotateCcw className="mr-1.5 h-3 w-3" />
+                  Retry
+                </Button>
+                <Button variant="outline" size="sm" onClick={onClose}>
+                  <X className="mr-1.5 h-3 w-3" />
+                  Close
+                </Button>
+              </>
+            )}
+          </div>
+        </DialogHeader>
+
+        <div className="flex flex-col gap-2">
+          <div className="text-muted-foreground text-sm">{getStatusText()}</div>
+
+          {error && (
+            <div className="rounded-lg border border-destructive/50 bg-destructive/10 p-3 text-destructive text-sm">
+              <div className="font-medium">Error Details</div>
+              <div className="mt-1 whitespace-pre-wrap font-mono text-xs">
+                {error.message}
+              </div>
+            </div>
+          )}
+
+          <div className="max-h-[50vh] overflow-y-auto rounded-lg border border-border bg-muted/30 p-4">
+            {assistantMessages.length === 0 ? (
+              <div className="text-muted-foreground text-sm">
+                {isProcessing
+                  ? 'Waiting for response...'
+                  : 'No output available.'}
+              </div>
+            ) : (
+              <div className="space-y-4">
+                {assistantMessages.map((message) => (
+                  <div key={message.id} className="whitespace-pre-wrap text-sm">
+                    {getMessageContent(message)}
+                  </div>
+                ))}
+              </div>
+            )}
+          </div>
+        </div>
+      </DialogContent>
+    </Dialog>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/workflows/WorkflowCard.tsx

@@ -0,0 +1,51 @@
+import { Pencil, Play, Trash2 } from 'lucide-react'
+import type { FC } from 'react'
+import { NavLink } from 'react-router'
+import { Button } from '@/components/ui/button'
+import type { Workflow } from '@/lib/workflows/workflowStorage'
+
+interface WorkflowCardProps {
+  workflow: Workflow
+  onDelete: () => void
+  onRun: () => void
+}
+
+export const WorkflowCard: FC<WorkflowCardProps> = ({
+  workflow,
+  onDelete,
+  onRun,
+}) => {
+  return (
+    <div className="rounded-xl border border-border bg-card p-4 shadow-sm transition-all hover:border-[var(--accent-orange)]/50 hover:shadow-sm">
+      <div className="flex items-center gap-4">
+        <div className="min-w-0 flex-1">
+          <span className="truncate font-semibold">
+            {workflow.workflowName}
+          </span>
+        </div>
+
+        <div className="flex shrink-0 items-center gap-2">
+          <Button variant="outline" size="sm" onClick={onRun}>
+            <Play className="mr-1.5 h-3 w-3" />
+            Run
+          </Button>
+          <Button asChild variant="outline" size="sm">
+            <NavLink to={`/workflows/create-graph?workflowId=${workflow.id}`}>
+              <Pencil className="mr-1.5 h-3 w-3" />
+              Edit
+            </NavLink>
+          </Button>
+          <Button
+            variant="ghost"
+            size="icon-sm"
+            onClick={onDelete}
+            className="text-muted-foreground hover:bg-destructive/10 hover:text-destructive"
+            aria-label={`Delete ${workflow.workflowName}`}
+          >
+            <Trash2 className="h-4 w-4" />
+          </Button>
+        </div>
+      </div>
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/workflows/WorkflowsHeader.tsx

@@ -0,0 +1,56 @@
+import { HelpCircle, Plus, Workflow } from 'lucide-react'
+import type { FC } from 'react'
+import { NavLink } from 'react-router'
+import { Button } from '@/components/ui/button'
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from '@/components/ui/tooltip'
+import { workflowsHelpUrl } from '@/lib/constants/productUrls'
+
+export const WorkflowsHeader: FC = () => {
+  return (
+    <div className="rounded-xl border border-border bg-card p-6 shadow-sm transition-all hover:shadow-md">
+      <div className="flex items-start gap-4">
+        <div className="flex h-12 w-12 shrink-0 items-center justify-center rounded-xl bg-[var(--accent-orange)]/10">
+          <Workflow className="h-6 w-6 text-[var(--accent-orange)]" />
+        </div>
+        <div className="flex-1">
+          <div className="mb-1 flex items-center gap-2">
+            <h2 className="font-semibold text-xl">Workflows</h2>
+            <TooltipProvider delayDuration={0}>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <a
+                    href={workflowsHelpUrl}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="rounded-full p-1 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground"
+                  >
+                    <HelpCircle className="h-4 w-4" />
+                  </a>
+                </TooltipTrigger>
+                <TooltipContent>Learn more about workflows</TooltipContent>
+              </Tooltip>
+            </TooltipProvider>
+          </div>
+          <p className="text-muted-foreground text-sm">
+            Create and manage browser automation workflows
+          </p>
+        </div>
+        <Button
+          asChild
+          className="border-[var(--accent-orange)] bg-[var(--accent-orange)]/10 text-[var(--accent-orange)] hover:bg-[var(--accent-orange)]/20 hover:text-[var(--accent-orange)]"
+          variant="outline"
+        >
+          <NavLink to="/workflows/create-graph">
+            <Plus className="mr-1.5 h-4 w-4" />
+            New Workflow
+          </NavLink>
+        </Button>
+      </div>
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/workflows/WorkflowsList.tsx

@@ -0,0 +1,40 @@
+import type { FC } from 'react'
+import type { Workflow } from '@/lib/workflows/workflowStorage'
+import { WorkflowCard } from './WorkflowCard'
+
+interface WorkflowsListProps {
+  workflows: Workflow[]
+  onDelete: (workflowId: string) => void
+  onRun: (workflowId: string) => void
+}
+
+export const WorkflowsList: FC<WorkflowsListProps> = ({
+  workflows,
+  onDelete,
+  onRun,
+}) => {
+  if (workflows.length === 0) {
+    return (
+      <div className="rounded-xl border border-border bg-card p-6 shadow-sm">
+        <div className="rounded-lg border border-border border-dashed py-8 text-center">
+          <p className="text-muted-foreground text-sm">
+            No workflows yet. Create one to automate browser tasks.
+          </p>
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div className="space-y-3">
+      {workflows.map((workflow) => (
+        <WorkflowCard
+          key={workflow.id}
+          workflow={workflow}
+          onDelete={() => onDelete(workflow.id)}
+          onRun={() => onRun(workflow.id)}
+        />
+      ))}
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/workflows/WorkflowsPage.tsx

@@ -0,0 +1,127 @@
+import { type FC, useState } from 'react'
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from '@/components/ui/alert-dialog'
+import {
+  WORKFLOW_DELETED_EVENT,
+  WORKFLOW_RUN_STARTED_EVENT,
+} from '@/lib/constants/analyticsEvents'
+import { track } from '@/lib/metrics/track'
+import { useRpcClient } from '@/lib/rpc/RpcClientProvider'
+import { sentry } from '@/lib/sentry/sentry'
+import { useWorkflows } from '@/lib/workflows/workflowStorage'
+import { RunWorkflowDialog } from './RunWorkflowDialog'
+import { useRunWorkflow } from './useRunWorkflow'
+import { WorkflowsHeader } from './WorkflowsHeader'
+import { WorkflowsList } from './WorkflowsList'
+
+export const WorkflowsPage: FC = () => {
+  const { workflows, removeWorkflow } = useWorkflows()
+  const rpcClient = useRpcClient()
+
+  const [deleteWorkflowId, setDeleteWorkflowId] = useState<string | null>(null)
+
+  const {
+    isRunning,
+    runningWorkflowName,
+    messages,
+    status,
+    wasCancelled,
+    error,
+    runWorkflow,
+    stopRun,
+    retry,
+    closeDialog,
+  } = useRunWorkflow()
+
+  const handleDelete = (workflowId: string) => {
+    setDeleteWorkflowId(workflowId)
+  }
+
+  const confirmDelete = async () => {
+    if (!deleteWorkflowId) return
+
+    const workflow = workflows.find((w) => w.id === deleteWorkflowId)
+    if (!workflow) return
+
+    try {
+      await rpcClient.graph[':id'].$delete({ param: { id: workflow.codeId } })
+    } catch (error) {
+      sentry.captureException(error, {
+        extra: {
+          message: 'Failed to delete graph from server',
+          codeId: workflow.codeId,
+          workflowId: deleteWorkflowId,
+        },
+      })
+    }
+
+    await removeWorkflow(deleteWorkflowId)
+    setDeleteWorkflowId(null)
+    track(WORKFLOW_DELETED_EVENT)
+  }
+
+  const handleRun = (workflowId: string) => {
+    const workflow = workflows.find((w) => w.id === workflowId)
+    if (workflow) {
+      track(WORKFLOW_RUN_STARTED_EVENT)
+      runWorkflow(workflow.codeId, workflow.workflowName)
+    }
+  }
+
+  const workflowToDelete = deleteWorkflowId
+    ? workflows.find((w) => w.id === deleteWorkflowId)
+    : null
+
+  return (
+    <div className="fade-in slide-in-from-bottom-5 animate-in space-y-6 duration-500">
+      <WorkflowsHeader />
+
+      <WorkflowsList
+        workflows={workflows}
+        onDelete={handleDelete}
+        onRun={handleRun}
+      />
+
+      <AlertDialog
+        open={deleteWorkflowId !== null}
+        onOpenChange={(open) => !open && setDeleteWorkflowId(null)}
+      >
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>Delete Workflow</AlertDialogTitle>
+            <AlertDialogDescription>
+              Delete "{workflowToDelete?.workflowName}"? This action cannot be
+              undone.
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogAction onClick={confirmDelete}>
+              Delete
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+
+      <RunWorkflowDialog
+        open={isRunning}
+        workflowName={runningWorkflowName}
+        messages={messages}
+        status={status}
+        wasCancelled={wasCancelled}
+        error={error}
+        onStop={stopRun}
+        onRetry={retry}
+        onClose={closeDialog}
+      />
+    </div>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/workflows/WorkflowsPageWrapper.tsx

@@ -0,0 +1,10 @@
+import { type FC, Suspense } from 'react'
+import { WorkflowsPage } from './WorkflowsPage'
+
+export const WorkflowsPageWrapper: FC = () => {
+  return (
+    <Suspense fallback={<div className="h-screen w-screen bg-background" />}>
+      <WorkflowsPage />
+    </Suspense>
+  )
+}

packages/browseros-agent/apps/agent/entrypoints/app/workflows/useRunWorkflow.ts

@@ -0,0 +1,167 @@
+import { useChat } from '@ai-sdk/react'
+import { DefaultChatTransport } from 'ai'
+import { compact } from 'es-toolkit/array'
+import { useEffect, useRef, useState } from 'react'
+import { useChatRefs } from '@/entrypoints/sidepanel/index/useChatRefs'
+import { useAgentServerUrl } from '@/lib/browseros/useBrowserOSProviders'
+import {
+  WORKFLOW_RUN_COMPLETED_EVENT,
+  WORKFLOW_RUN_RETRIED_EVENT,
+  WORKFLOW_RUN_STOPPED_EVENT,
+} from '@/lib/constants/analyticsEvents'
+import { track } from '@/lib/metrics/track'
+
+type WorkflowMessageMetadata = {
+  window?: chrome.windows.Window
+}
+
+export const useRunWorkflow = () => {
+  const [isRunning, setIsRunning] = useState(false)
+  const [runningWorkflowName, setRunningWorkflowName] = useState<string>('')
+  const [wasCancelled, setWasCancelled] = useState(false)
+  const codeIdRef = useRef<string | undefined>(undefined)
+
+  const { baseUrl: agentServerUrl } = useAgentServerUrl()
+
+  const {
+    selectedLlmProviderRef,
+    enabledMcpServersRef,
+    enabledCustomServersRef,
+    personalizationRef,
+  } = useChatRefs()
+
+  const agentUrlRef = useRef(agentServerUrl)
+
+  useEffect(() => {
+    agentUrlRef.current = agentServerUrl
+  }, [agentServerUrl])
+
+  const { sendMessage, stop, status, messages, setMessages, error } = useChat({
+    transport: new DefaultChatTransport({
+      prepareSendMessagesRequest: async ({ messages }) => {
+        const lastMessage = messages[messages.length - 1]
+        const metadata = lastMessage.metadata as
+          | WorkflowMessageMetadata
+          | undefined
+        const provider = selectedLlmProviderRef.current
+        const enabledMcpServers = enabledMcpServersRef.current
+        const customMcpServers = enabledCustomServersRef.current
+
+        return {
+          api: `${agentUrlRef.current}/graph/${codeIdRef.current}/run`,
+          body: {
+            provider: provider?.type,
+            providerType: provider?.type,
+            providerName: provider?.name,
+            model: provider?.modelId ?? 'browseros',
+            contextWindowSize: provider?.contextWindow,
+            temperature: provider?.temperature,
+            resourceName: provider?.resourceName,
+            accessKeyId: provider?.accessKeyId,
+            secretAccessKey: provider?.secretAccessKey,
+            region: provider?.region,
+            sessionToken: provider?.sessionToken,
+            apiKey: provider?.apiKey,
+            baseUrl: provider?.baseUrl,
+            browserContext: {
+              windowId: metadata?.window?.id,
+              activeTab: metadata?.window?.tabs?.[0],
+              enabledMcpServers: compact(enabledMcpServers),
+              customMcpServers,
+            },
+            userSystemPrompt: personalizationRef.current,
+            supportsImages: provider?.supportsImages,
+          },
+        }
+      },
+    }),
+  })
+
+  const previousStatus = useRef(status)
+  useEffect(() => {
+    const wasProcessing =
+      previousStatus.current === 'streaming' ||
+      previousStatus.current === 'submitted'
+    const justFinished =
+      wasProcessing && (status === 'ready' || status === 'error')
+
+    if (justFinished && isRunning) {
+      track(WORKFLOW_RUN_COMPLETED_EVENT, {
+        status: wasCancelled
+          ? 'cancelled'
+          : status === 'error'
+            ? 'failed'
+            : 'completed',
+      })
+    }
+    previousStatus.current = status
+  }, [status, isRunning, wasCancelled])
+
+  const startWorkflowRun = async () => {
+    setMessages([])
+    setWasCancelled(false)
+
+    let backgroundWindow: chrome.windows.Window | undefined
+    try {
+      backgroundWindow = await chrome.windows.create({
+        url: 'chrome://newtab',
+        focused: true,
+        type: 'normal',
+      })
+    } catch {
+      // Fallback when no window context is available (e.g. all windows closed)
+      const tab = await chrome.tabs.create({
+        url: 'chrome://newtab',
+        active: true,
+      })
+      if (tab.windowId) {
+        backgroundWindow = await chrome.windows.get(tab.windowId)
+      }
+    }
+
+    sendMessage({
+      text: 'Run the workflow.',
+      metadata: {
+        window: backgroundWindow,
+      },
+    })
+  }
+
+  const runWorkflow = async (codeId: string, workflowName: string) => {
+    codeIdRef.current = codeId
+    setRunningWorkflowName(workflowName)
+    setIsRunning(true)
+    await startWorkflowRun()
+  }
+
+  const stopRun = () => {
+    track(WORKFLOW_RUN_STOPPED_EVENT)
+    setWasCancelled(true)
+    stop()
+  }
+
+  const retry = async () => {
+    track(WORKFLOW_RUN_RETRIED_EVENT)
+    await startWorkflowRun()
+  }
+
+  const closeDialog = () => {
+    setIsRunning(false)
+    setRunningWorkflowName('')
+    setWasCancelled(false)
+    setMessages([])
+  }
+
+  return {
+    isRunning,
+    runningWorkflowName,
+    messages,
+    status,
+    wasCancelled,
+    error,
+    runWorkflow,
+    stopRun,
+    retry,
+    closeDialog,
+  }
+}

packages/browseros-agent/apps/agent/entrypoints/newtab/index/tips.ts

@@ -45,7 +45,7 @@ export const TIPS: Tip[] = [
   },
   {
     id: 'mcp-servers',
-    text: 'Add MCP servers for Google Calendar, Gmail, Notion, and more to power multi-service automations.',
+    text: 'Add MCP servers for Google Calendar, Gmail, Notion, and more to build multi-service workflows.',
   },
   {
     id: 'skills',
@@ -75,6 +75,10 @@ export const TIPS: Tip[] = [
     id: 'at-mention-tabs',
     text: 'Type @ in the search bar to mention and attach open tabs as context for your AI queries.',
   },
+  {
+    id: 'workflows',
+    text: 'For complex repeatable tasks, build visual Workflows instead of one-off prompts for consistent results.',
+  },
   {
     id: 'mode-selection',
     text: 'Use Chat mode for read-only operations like questions and summaries, and Agent mode for multi-step browser tasks.',

packages/browseros-agent/apps/agent/entrypoints/onboarding/features/Features.tsx

@@ -5,6 +5,7 @@ import {
   Bot,
   Code2,
   FolderOpen,
+  GitBranch,
   LinkIcon,
   Plug,
   SplitSquareHorizontal,
@@ -22,6 +23,7 @@ import {
   COWORK_DEMO_URL,
   MCP_SERVER_DEMO_URL,
   SPLIT_VIEW_GIF_URL,
+  WORKFLOWS_DEMO_URL,
 } from '@/lib/constants/mediaUrls'
 import {
   discordUrl,
@@ -42,7 +44,7 @@ const features: Feature[] = [
     description:
       'Describe any task and watch BrowserOS execute it—clicking, typing, and navigating for you.',
     detailedDescription:
-      'The BrowserOS Agent turns your words into browser actions. Describe what you need in plain English—fill out this form, extract data from that page, navigate through these steps—and the agent handles the rest. It clicks buttons, types text, navigates between pages, and completes multi-step browser tasks automatically. Everything runs locally on your machine with your own API keys, so your data stays private.',
+      'The BrowserOS Agent turns your words into browser actions. Describe what you need in plain English—fill out this form, extract data from that page, navigate through these steps—and the agent handles the rest. It clicks buttons, types text, navigates between pages, and completes multi-step workflows automatically. Everything runs locally on your machine with your own API keys, so your data stays private.',
     highlights: [
       'Multi-tab execution — run agents in multiple tabs simultaneously',
       'Smart navigation — automatically finds and interacts with page elements',
@@ -73,6 +75,24 @@ const features: Feature[] = [
     gridClass: 'md:col-span-1',
     videoUrl: MCP_SERVER_DEMO_URL,
   },
+  {
+    id: 'workflows',
+    Icon: GitBranch,
+    tag: 'AUTOMATION',
+    title: 'Visual Workflows',
+    description:
+      'Build reliable, repeatable automations with a visual graph builder.',
+    detailedDescription:
+      'Workflows turn complex browser tasks into reliable, reusable automations. Instead of hoping the agent figures out the right steps each time, you define the exact sequence in a visual graph. Describe what you want in chat, and the workflow agent generates the graph. Add loops, conditionals, and parallel branches. Save workflows and run them on-demand whenever you need.',
+    highlights: [
+      'Chat-to-graph — describe your automation and get a visual workflow',
+      'Parallel execution — run multiple branches simultaneously',
+      'Loops & conditionals — handle complex logic with flow control',
+      'Save & reuse — run saved workflows on-demand, daily, or weekly',
+    ],
+    gridClass: 'md:col-span-1',
+    videoUrl: WORKFLOWS_DEMO_URL || undefined,
+  },
   {
     id: 'cowork',
     Icon: FolderOpen,

packages/browseros-agent/apps/agent/lib/browseros/capabilities.ts

@@ -31,6 +31,8 @@ export enum Feature {
   WORKSPACE_FOLDER_SUPPORT = 'WORKSPACE_FOLDER_SUPPORT',
   // Proxy server support
   PROXY_SUPPORT = 'PROXY_SUPPORT',
+  // Workflows feature
+  WORKFLOW_SUPPORT = 'WORKFLOW_SUPPORT',
   // previousConversation as structured array (older servers only accept string)
   PREVIOUS_CONVERSATION_ARRAY = 'PREVIOUS_CONVERSATION_ARRAY',
   // Soul page: agent personality viewer and editor
@@ -71,6 +73,7 @@ const FEATURE_CONFIG: { [K in Feature]: FeatureConfig } = {
   [Feature.CUSTOMIZATION_SUPPORT]: { minBrowserOSVersion: '0.36.1.0' },
   [Feature.WORKSPACE_FOLDER_SUPPORT]: { minBrowserOSVersion: '0.36.4.0' },
   [Feature.PROXY_SUPPORT]: { minBrowserOSVersion: '0.39.0.1' },
+  [Feature.WORKFLOW_SUPPORT]: { minServerVersion: '0.0.41' },
   [Feature.PREVIOUS_CONVERSATION_ARRAY]: { minServerVersion: '0.0.64' },
   [Feature.SOUL_SUPPORT]: { minServerVersion: '0.0.67' },
   [Feature.NEWTAB_CHAT_SUPPORT]: { minBrowserOSVersion: '0.40.0.0' },

packages/browseros-agent/apps/agent/lib/constants/analyticsEvents.ts

@@ -1,6 +1,19 @@
 /** @public */
 export const MESSAGE_LIKE_EVENT = 'ui.message.like'
 
+export const GRAPH_MESSAGE_LIKE_EVENT = 'settings.graph.message.like'
+
+export const GRAPH_MESSAGE_DISLIKE_EVENT = 'settings.graph.message.dislike'
+
+/** @public */
+export const NEW_GRAPH_CREATED_EVENT = 'settings.graph.created'
+
+/** @public */
+export const GRAPH_SAVED_EVENT = 'settings.graph.saved'
+
+/** @public */
+export const GRAPH_UPDATED_EVENT = 'settings.graph.updated'
+
 /** @public */
 export const MESSAGE_DISLIKE_EVENT = 'ui.message.dislike'
 
@@ -165,6 +178,21 @@ export const NEWTAB_VOICE_TRANSCRIPTION_COMPLETED_EVENT =
 /** @public */
 export const NEWTAB_VOICE_ERROR_EVENT = 'newtab.voice.error'
 
+/** @public */
+export const WORKFLOW_DELETED_EVENT = 'settings.workflow.deleted'
+
+/** @public */
+export const WORKFLOW_RUN_STARTED_EVENT = 'settings.workflow.run_started'
+
+/** @public */
+export const WORKFLOW_RUN_STOPPED_EVENT = 'settings.workflow.run_stopped'
+
+/** @public */
+export const WORKFLOW_RUN_RETRIED_EVENT = 'settings.workflow.run_retried'
+
+/** @public */
+export const WORKFLOW_RUN_COMPLETED_EVENT = 'settings.workflow.run_completed'
+
 /** @public */
 export const SIDEPANEL_AI_TRIGGERED_EVENT = 'sidepanel.ai.triggered'
 

packages/browseros-agent/apps/agent/lib/constants/productUrls.ts

@@ -49,6 +49,11 @@ export const productVideoUrl = 'https://youtu.be/J-lFhTP-7is'
  */
 export const productRepositoryShortUrl = 'https://git.new/browseros'
 
+/**
+ * @public
+ */
+export const workflowsHelpUrl = 'https://docs.browseros.com/features/workflows'
+
 /**
  * @public
  */

packages/browseros-agent/apps/agent/lib/workflows/workflowStorage.ts

@@ -0,0 +1,54 @@
+import { storage } from '@wxt-dev/storage'
+import { useEffect, useState } from 'react'
+
+export interface Workflow {
+  id: string
+  codeId: string
+  workflowName: string
+}
+
+export const workflowStorage = storage.defineItem<Workflow[]>(
+  'local:workflows',
+  {
+    fallback: [],
+  },
+)
+
+export function useWorkflows() {
+  const [workflows, setWorkflows] = useState<Workflow[]>([])
+
+  useEffect(() => {
+    workflowStorage.getValue().then(setWorkflows)
+    const unwatch = workflowStorage.watch((newValue) => {
+      setWorkflows(newValue ?? [])
+    })
+    return unwatch
+  }, [])
+
+  const addWorkflow = async (workflow: Omit<Workflow, 'id'>) => {
+    const newWorkflow: Workflow = {
+      id: crypto.randomUUID(),
+      ...workflow,
+    }
+    const current = (await workflowStorage.getValue()) ?? []
+    await workflowStorage.setValue([...current, newWorkflow])
+    return newWorkflow
+  }
+
+  const removeWorkflow = async (id: string) => {
+    const current = (await workflowStorage.getValue()) ?? []
+    await workflowStorage.setValue(current.filter((w) => w.id !== id))
+  }
+
+  const editWorkflow = async (
+    id: string,
+    updates: Partial<Omit<Workflow, 'id'>>,
+  ) => {
+    const current = (await workflowStorage.getValue()) ?? []
+    await workflowStorage.setValue(
+      current.map((w) => (w.id === id ? { ...w, ...updates } : w)),
+    )
+  }
+
+  return { workflows, addWorkflow, removeWorkflow, editWorkflow }
+}

packages/browseros-agent/apps/agent/package.json

@@ -2,7 +2,7 @@
   "name": "@browseros/agent",
   "description": "manifest.json description",
   "private": true,
-  "version": "0.0.99",
+  "version": "0.0.98",
   "type": "module",
   "scripts": {
     "dev": "test -d generated/graphql || bun run codegen; mkdir -p /tmp/browseros-dev; bun --env-file=.env.development wxt",

packages/browseros-agent/apps/server/README.md

@@ -92,6 +92,10 @@ Skills are custom instruction sets that shape agent behavior:
 - **Loader** (`src/skills/loader.ts`) — loads skills from local and remote sources
 - **Remote sync** (`src/skills/remote-sync.ts`) — syncs skills from the BrowserOS cloud
 
+## Graph Executor (Workflows)
+
+The graph executor (`src/graph/executor.ts`) runs visual workflow graphs built in the BrowserOS workflow editor. Each node in the graph maps to agent actions, conditionals, or data transformations.
+
 ## Directory Structure
 
 ```
@@ -116,12 +120,14 @@ apps/server/
 │   │   ├── filesystem/
 │   │   └── ...
 │   ├── skills/                # Skills system
+│   ├── graph/                 # Workflow graph executor
 │   ├── lib/                   # Shared utilities
 │   └── rpc.ts                 # JSON-RPC type definitions
 ├── tests/
 │   ├── tools/                 # Tool-level tests
 │   ├── sdk/                   # SDK integration tests
 │   └── server.integration.test.ts
+├── graph/                     # Workflow graph definitions
 └── package.json
 ```
 

packages/browseros-agent/apps/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browseros/server",
-  "version": "0.0.82",
+  "version": "0.0.80",
   "description": "BrowserOS server",
   "type": "module",
   "main": "./src/index.ts",

packages/browseros-agent/apps/server/src/agent/mcp-builder.ts

@@ -2,7 +2,6 @@ import { createMCPClient } from '@ai-sdk/mcp'
 import { TIMEOUTS } from '@browseros/shared/constants/timeouts'
 import type { BrowserContext } from '@browseros/shared/schemas/browser-context'
 import type { ToolSet } from 'ai'
-import { klavisStrataCache } from '../api/services/klavis/strata-cache'
 import type { KlavisClient } from '../lib/clients/klavis/klavis-client'
 import { logger } from '../lib/logger'
 import {
@@ -41,8 +40,7 @@ export async function buildMcpServerSpecs(
     deps.browserContext?.enabledMcpServers?.length
   ) {
     try {
-      const result = await klavisStrataCache.getOrFetch(
-        deps.klavisClient,
+      const result = await deps.klavisClient.createStrata(
         deps.browserosId,
         deps.browserContext.enabledMcpServers,
       )

packages/browseros-agent/apps/server/src/api/routes/graph.ts

@@ -0,0 +1,274 @@
+/**
+ * @license
+ * Copyright 2025 BrowserOS
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import { PATHS } from '@browseros/shared/constants/paths'
+import { zValidator } from '@hono/zod-validator'
+import type { Context } from 'hono'
+import { Hono } from 'hono'
+import { stream } from 'hono/streaming'
+import { logger } from '../../lib/logger'
+import { GraphService } from '../services/graph-service'
+import {
+  CreateGraphRequestSchema,
+  RunGraphRequestSchema,
+  UpdateGraphRequestSchema,
+} from '../types'
+import {
+  formatUIMessageStreamDone,
+  formatUIMessageStreamEvent,
+} from '../utils/ui-message-stream'
+import { SessionIdParamSchema } from '../utils/validation'
+
+interface SSEStreamOptions {
+  vercelAIStream?: boolean
+  logLabel: string
+}
+
+type SSEStreamCallback = (
+  stream: { write: (data: string) => Promise<unknown> },
+  signal: AbortSignal,
+) => Promise<void>
+
+function createSSEStream(
+  c: Context,
+  options: SSEStreamOptions,
+  callback: SSEStreamCallback,
+) {
+  c.header('Content-Type', 'text/event-stream')
+  c.header('Cache-Control', 'no-cache')
+  c.header('Connection', 'keep-alive')
+
+  if (options.vercelAIStream) {
+    c.header('x-vercel-ai-ui-message-stream', 'v1')
+  }
+
+  const abortController = new AbortController()
+
+  if (c.req.raw.signal) {
+    c.req.raw.signal.addEventListener('abort', () => abortController.abort(), {
+      once: true,
+    })
+  }
+
+  return stream(c, async (honoStream) => {
+    honoStream.onAbort(() => {
+      abortController.abort()
+      logger.debug(`${options.logLabel} stream aborted`)
+    })
+
+    await callback(honoStream, abortController.signal)
+  })
+}
+
+interface GraphRouteDeps {
+  port: number
+  tempDir?: string
+  codegenServiceUrl?: string
+}
+
+export function createGraphRoutes(deps: GraphRouteDeps) {
+  const { port, codegenServiceUrl } = deps
+
+  const serverUrl = `http://127.0.0.1:${port}`
+  const tempDir = deps.tempDir || PATHS.DEFAULT_EXECUTION_DIR
+
+  const graphService = codegenServiceUrl
+    ? new GraphService({ codegenServiceUrl, serverUrl, tempDir })
+    : null
+
+  // Chain route definitions for proper Hono RPC type inference
+  return new Hono()
+    .post('/', zValidator('json', CreateGraphRequestSchema), async (c) => {
+      if (!graphService) {
+        return c.json({ error: 'CODEGEN_SERVICE_URL not configured' }, 503)
+      }
+      const request = c.req.valid('json')
+      logger.info('Graph create request received', { query: request.query })
+
+      return createSSEStream(
+        c,
+        { logLabel: 'Graph create', vercelAIStream: true },
+        async (s, signal) => {
+          try {
+            await graphService.createGraph(
+              request.query,
+              async (event) => {
+                await s.write(formatUIMessageStreamEvent(event))
+              },
+              signal,
+            )
+          } catch (error) {
+            const errorMessage =
+              error instanceof Error ? error.message : String(error)
+            await s.write(
+              formatUIMessageStreamEvent({
+                type: 'error',
+                errorText: errorMessage,
+              }),
+            )
+            await s.write(
+              formatUIMessageStreamEvent({
+                type: 'finish',
+                finishReason: 'error',
+              }),
+            )
+          } finally {
+            await s.write(formatUIMessageStreamDone())
+          }
+        },
+      )
+    })
+    .post(
+      '/:id',
+      zValidator('param', SessionIdParamSchema),
+      zValidator('json', UpdateGraphRequestSchema),
+      async (c) => {
+        if (!graphService) {
+          return c.json({ error: 'CODEGEN_SERVICE_URL not configured' }, 503)
+        }
+        const { id: sessionId } = c.req.valid('param')
+        const request = c.req.valid('json')
+        logger.info('Graph update request received', {
+          sessionId,
+          query: request.query,
+        })
+
+        return createSSEStream(
+          c,
+          { logLabel: 'Graph update', vercelAIStream: true },
+          async (s, signal) => {
+            try {
+              await graphService.updateGraph(
+                sessionId,
+                request.query,
+                async (event) => {
+                  await s.write(formatUIMessageStreamEvent(event))
+                },
+                signal,
+              )
+            } catch (error) {
+              const errorMessage =
+                error instanceof Error ? error.message : String(error)
+              await s.write(
+                formatUIMessageStreamEvent({
+                  type: 'error',
+                  errorText: errorMessage,
+                }),
+              )
+              await s.write(
+                formatUIMessageStreamEvent({
+                  type: 'finish',
+                  finishReason: 'error',
+                }),
+              )
+            } finally {
+              await s.write(formatUIMessageStreamDone())
+            }
+          },
+        )
+      },
+    )
+    .get('/:id', zValidator('param', SessionIdParamSchema), async (c) => {
+      if (!graphService) {
+        return c.json({ error: 'CODEGEN_SERVICE_URL not configured' }, 503)
+      }
+      const { id: sessionId } = c.req.valid('param')
+
+      logger.debug('Graph get request received', { sessionId })
+
+      const session = await graphService.getGraph(sessionId)
+
+      if (!session) {
+        return c.json({ error: 'Graph not found' }, 404)
+      }
+
+      return c.json(session)
+    })
+    .post(
+      '/:id/run',
+      zValidator('param', SessionIdParamSchema),
+      zValidator('json', RunGraphRequestSchema),
+      async (c) => {
+        if (!graphService) {
+          return c.json({ error: 'CODEGEN_SERVICE_URL not configured' }, 503)
+        }
+        const { id: sessionId } = c.req.valid('param')
+        const request = c.req.valid('json')
+        logger.info('Graph run request received', {
+          sessionId,
+          provider: request.provider,
+          model: request.model,
+        })
+
+        return createSSEStream(
+          c,
+          { logLabel: 'Graph run', vercelAIStream: true },
+          async (s, signal) => {
+            try {
+              // Emit start event at route level
+              await s.write(
+                formatUIMessageStreamEvent({
+                  type: 'start',
+                  messageId: sessionId,
+                }),
+              )
+
+              await graphService.runGraph(
+                sessionId,
+                request,
+                async (event) => {
+                  // Agent SDK handles proper event formatting
+                  // Skip start/finish (managed at route level), forward everything else
+                  if (event.type === 'start' || event.type === 'finish') {
+                    return
+                  }
+                  await s.write(formatUIMessageStreamEvent(event))
+                },
+                signal,
+              )
+
+              // Emit finish at route level
+              await s.write(
+                formatUIMessageStreamEvent({
+                  type: 'finish',
+                  finishReason: 'stop',
+                }),
+              )
+            } catch (error) {
+              const errorMessage =
+                error instanceof Error ? error.message : String(error)
+              await s.write(
+                formatUIMessageStreamEvent({
+                  type: 'error',
+                  errorText: errorMessage,
+                }),
+              )
+              await s.write(
+                formatUIMessageStreamEvent({
+                  type: 'finish',
+                  finishReason: 'error',
+                }),
+              )
+            } finally {
+              await s.write(formatUIMessageStreamDone())
+            }
+          },
+        )
+      },
+    )
+    .delete('/:id', zValidator('param', SessionIdParamSchema), async (c) => {
+      if (!graphService) {
+        return c.json({ error: 'CODEGEN_SERVICE_URL not configured' }, 503)
+      }
+      const { id: sessionId } = c.req.valid('param')
+
+      logger.debug('Graph delete request received', { sessionId })
+
+      await graphService.deleteGraph(sessionId)
+
+      return c.json({ success: true, message: `Graph ${sessionId} deleted` })
+    })
+}

packages/browseros-agent/apps/server/src/api/routes/klavis.ts

@@ -10,7 +10,6 @@ import { z } from 'zod'
 import { KlavisClient } from '../../lib/clients/klavis/klavis-client'
 import { OAUTH_MCP_SERVERS } from '../../lib/clients/klavis/oauth-mcp-servers'
 import { logger } from '../../lib/logger'
-import { klavisStrataCache } from '../services/klavis/strata-cache'
 
 const ServerNameSchema = z.object({
   serverName: z.string().min(1),
@@ -126,7 +125,6 @@ export function createKlavisRoutes(deps: KlavisRouteDeps) {
       logger.info('Adding server to strata', { serverName })
 
       const result = await klavisClient.createStrata(browserosId, [serverName])
-      klavisStrataCache.invalidate(browserosId)
 
       return c.json({
         success: true,
@@ -186,17 +184,7 @@ export function createKlavisRoutes(deps: KlavisRouteDeps) {
 
         logger.info('Removing server from strata', { serverName })
 
-        // The chat hot path keys its cache by the user's full enabled set,
-        // so a single-server lookup here would always miss and immediately
-        // be cleared by invalidate() below — call createStrata directly
-        // to recover the strataId, mirroring the original removeServer flow.
-        const strata = await klavisClient.createStrata(browserosId, [
-          serverName,
-        ])
-        await klavisClient.deleteServersFromStrata(strata.strataId, [
-          serverName,
-        ])
-        klavisStrataCache.invalidate(browserosId)
+        await klavisClient.removeServer(browserosId, serverName)
 
         return c.json({
           success: true,

packages/browseros-agent/apps/server/src/api/routes/mcp.ts

@@ -11,8 +11,8 @@ import { logger } from '../../lib/logger'
 import { metrics } from '../../lib/metrics'
 import { Sentry } from '../../lib/sentry'
 import type { ToolRegistry } from '../../tools/tool-registry'
-import type { KlavisProxyHandle } from '../services/klavis/strata-proxy'
 import { createMcpServer } from '../services/mcp/mcp-server'
+import type { KlavisProxyHandle } from '../services/mcp/register-klavis-mcp'
 import type { Env } from '../types'
 
 interface McpRouteDeps {

packages/browseros-agent/apps/server/src/api/server.ts

@@ -22,6 +22,7 @@ import { logger } from '../lib/logger'
 import { Sentry } from '../lib/sentry'
 import { createChatRoutes } from './routes/chat'
 import { createCreditsRoutes } from './routes/credits'
+import { createGraphRoutes } from './routes/graph'
 import { createHealthRoute } from './routes/health'
 import { createKlavisRoutes } from './routes/klavis'
 import { createMcpRoutes } from './routes/mcp'
@@ -37,7 +38,7 @@ import { createStatusRoute } from './routes/status'
 import {
   connectKlavisProxy,
   type KlavisProxyHandle,
-} from './services/klavis/strata-proxy'
+} from './services/mcp/register-klavis-mcp'
 import type { Env, HttpServerConfig } from './types'
 import { defaultCorsConfig } from './utils/cors'
 
@@ -170,6 +171,14 @@ export async function createHttpServer(config: HttpServerConfig) {
         browserosId,
       }),
     )
+    .route(
+      '/graph',
+      createGraphRoutes({
+        port,
+        tempDir: executionDir,
+        codegenServiceUrl: config.codegenServiceUrl,
+      }),
+    )
 
   // Error handler
   app.onError((err, c) => {

packages/browseros-agent/apps/server/src/api/services/graph-service.ts

@@ -0,0 +1,328 @@
+/**
+ * @license
+ * Copyright 2025 BrowserOS
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import { UIMessageStreamEventSchema } from '@browseros/shared/schemas/ui-stream'
+import type { LLMConfig, UIMessageStreamEvent } from '@browseros-ai/agent-sdk'
+import { createParser, type EventSourceMessage } from 'eventsource-parser'
+import { cleanupExecution, executeGraph } from '../../graph/executor'
+import { logger } from '../../lib/logger'
+import {
+  CodegenFinishMetadataSchema,
+  CodegenGetResponseSchema,
+  type GraphSession,
+  type RunGraphRequest,
+  type WorkflowGraph,
+} from '../types'
+
+export interface GraphServiceDeps {
+  codegenServiceUrl: string
+  serverUrl: string
+  tempDir: string
+}
+
+interface SessionState {
+  codeId: string | null
+  code: string | null
+  graph: WorkflowGraph | null
+}
+
+export class GraphService {
+  constructor(private deps: GraphServiceDeps) {}
+
+  /**
+   * Create a new graph by proxying to codegen service.
+   * Streams UIMessageStreamEvent events back to caller.
+   */
+  async createGraph(
+    query: string,
+    onEvent: (event: UIMessageStreamEvent) => Promise<void>,
+    signal?: AbortSignal,
+  ): Promise<GraphSession | null> {
+    const url = `${this.deps.codegenServiceUrl}/api/code`
+
+    logger.debug('Creating graph via codegen service', { url, query })
+
+    return this.proxyCodegenRequest(url, 'POST', { query }, onEvent, signal)
+  }
+
+  /**
+   * Update an existing graph by proxying to codegen service.
+   */
+  async updateGraph(
+    sessionId: string,
+    query: string,
+    onEvent: (event: UIMessageStreamEvent) => Promise<void>,
+    signal?: AbortSignal,
+  ): Promise<GraphSession | null> {
+    const url = `${this.deps.codegenServiceUrl}/api/code/${sessionId}`
+
+    logger.debug('Updating graph via codegen service', {
+      url,
+      sessionId,
+      query,
+    })
+
+    return this.proxyCodegenRequest(url, 'PUT', { query }, onEvent, signal)
+  }
+
+  /**
+   * Get graph code and visualization from codegen service.
+   */
+  async getGraph(sessionId: string): Promise<GraphSession | null> {
+    const url = `${this.deps.codegenServiceUrl}/api/code/${sessionId}`
+
+    logger.debug('Fetching graph from codegen service', { url, sessionId })
+
+    try {
+      const response = await fetch(url)
+
+      if (!response.ok) {
+        if (response.status === 404) {
+          return null
+        }
+        throw new Error(`Codegen service error: ${response.status}`)
+      }
+
+      const json = await response.json()
+      const result = CodegenGetResponseSchema.safeParse(json)
+
+      if (!result.success) {
+        logger.error('Invalid codegen response', {
+          issues: result.error.issues,
+        })
+        throw new Error('Invalid response from codegen service')
+      }
+
+      return {
+        id: sessionId,
+        code: result.data.code,
+        graph: result.data.graph,
+        createdAt: new Date(result.data.createdAt || Date.now()),
+      }
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.message : String(error)
+      logger.error('Failed to fetch graph', { sessionId, error: errorMessage })
+      throw error
+    }
+  }
+
+  /**
+   * Execute a graph by fetching code from codegen and running it.
+   */
+  async runGraph(
+    sessionId: string,
+    request: RunGraphRequest,
+    onProgress: (event: UIMessageStreamEvent) => Promise<void>,
+    signal?: AbortSignal,
+  ): Promise<void> {
+    // Fetch code from codegen service
+    const graph = await this.getGraph(sessionId)
+
+    if (!graph) {
+      throw new Error(`Graph not found: ${sessionId}`)
+    }
+
+    logger.debug('Executing graph', {
+      sessionId,
+      codeLength: graph.code.length,
+    })
+
+    // Build LLM config from request
+    const llmConfig: LLMConfig | undefined = request.provider
+      ? {
+          provider: request.provider,
+          model: request.model,
+          apiKey: request.apiKey,
+          baseUrl: request.baseUrl,
+          resourceName: request.resourceName,
+          region: request.region,
+          accessKeyId: request.accessKeyId,
+          secretAccessKey: request.secretAccessKey,
+          sessionToken: request.sessionToken,
+        }
+      : undefined
+
+    const result = await executeGraph(
+      graph.code,
+      sessionId,
+      this.deps.tempDir,
+      {
+        serverUrl: this.deps.serverUrl,
+        llmConfig,
+        browserContext: request.browserContext,
+        onProgress: (event) => {
+          onProgress(event).catch((err) => {
+            logger.warn('Failed to send progress event', { error: String(err) })
+          })
+        },
+        signal,
+      },
+    )
+
+    if (!result.success) {
+      throw new Error(result.error || 'Graph execution failed')
+    }
+  }
+
+  /**
+   * Delete execution files for a graph.
+   */
+  async deleteGraph(sessionId: string): Promise<void> {
+    await cleanupExecution(sessionId, this.deps.tempDir)
+  }
+
+  /**
+   * Proxy a request to codegen service and stream UIMessageStreamEvent events.
+   */
+  private async proxyCodegenRequest(
+    url: string,
+    method: 'POST' | 'PUT',
+    body: { query: string },
+    onEvent: (event: UIMessageStreamEvent) => Promise<void>,
+    signal?: AbortSignal,
+  ): Promise<GraphSession | null> {
+    try {
+      const response = await this.fetchCodegenService(url, method, body, signal)
+      return await this.parseUIMessageStream(response, onEvent)
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.message : String(error)
+      logger.error('Codegen proxy request failed', { url, error: errorMessage })
+      throw error
+    }
+  }
+
+  private async fetchCodegenService(
+    url: string,
+    method: 'POST' | 'PUT',
+    body: { query: string },
+    signal?: AbortSignal,
+  ): Promise<Response> {
+    const response = await fetch(url, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        Accept: 'text/event-stream',
+      },
+      body: JSON.stringify(body),
+      signal,
+    })
+
+    if (!response.ok) {
+      throw new Error(`Codegen service error: ${response.status}`)
+    }
+
+    if (!response.body) {
+      throw new Error('No response body from codegen service')
+    }
+
+    return response
+  }
+
+  /**
+   * Parse UIMessageStreamEvent SSE stream from codegen service.
+   * Extracts codeId, code, graph from the finish event's messageMetadata.
+   */
+  private async parseUIMessageStream(
+    response: Response,
+    onEvent: (event: UIMessageStreamEvent) => Promise<void>,
+  ): Promise<GraphSession | null> {
+    if (!response.body) {
+      throw new Error('No response body')
+    }
+
+    const reader = response.body.getReader()
+    const decoder = new TextDecoder()
+    const state: SessionState = { codeId: null, code: null, graph: null }
+    const pendingEvents: UIMessageStreamEvent[] = []
+
+    const parser = createParser({
+      onEvent: (msg: EventSourceMessage) => {
+        if (msg.data === '[DONE]') return
+
+        try {
+          const json = JSON.parse(msg.data)
+          const result = UIMessageStreamEventSchema.safeParse(json)
+
+          if (!result.success) {
+            logger.warn('Invalid UIMessageStream event', {
+              data: msg.data,
+              issues: result.error.issues,
+            })
+            return
+          }
+
+          pendingEvents.push(result.data as UIMessageStreamEvent)
+        } catch {
+          logger.warn('Failed to parse UIMessageStream event', {
+            data: msg.data,
+          })
+        }
+      },
+    })
+
+    try {
+      while (true) {
+        const { done, value } = await reader.read()
+        if (done) break
+
+        const text = decoder.decode(value, { stream: true })
+        parser.feed(text)
+
+        // Process any events that were parsed
+        let event = pendingEvents.shift()
+        while (event) {
+          this.extractSessionData(event, state)
+          await onEvent(event)
+          event = pendingEvents.shift()
+        }
+      }
+
+      // Process any remaining events
+      let remaining = pendingEvents.shift()
+      while (remaining) {
+        this.extractSessionData(remaining, state)
+        await onEvent(remaining)
+        remaining = pendingEvents.shift()
+      }
+
+      if (state.codeId && state.code) {
+        return {
+          id: state.codeId,
+          code: state.code,
+          graph: state.graph,
+          createdAt: new Date(),
+        }
+      }
+
+      return null
+    } finally {
+      reader.releaseLock()
+    }
+  }
+
+  /**
+   * Extract session data (codeId, code, graph) from UIMessageStreamEvent.
+   */
+  private extractSessionData(
+    event: UIMessageStreamEvent,
+    state: SessionState,
+  ): void {
+    if (event.type === 'start' && event.messageId) {
+      state.codeId = event.messageId
+    } else if (event.type === 'finish' && event.messageMetadata) {
+      const result = CodegenFinishMetadataSchema.safeParse(
+        event.messageMetadata,
+      )
+      if (result.success) {
+        if (result.data.codeId) state.codeId = result.data.codeId
+        if (result.data.code) state.code = result.data.code
+        if (result.data.graph !== undefined) state.graph = result.data.graph
+      }
+    }
+  }
+}

packages/browseros-agent/apps/server/src/api/services/klavis/strata-cache.ts

@@ -1,145 +0,0 @@
-/**
- * @license
- * Copyright 2025 BrowserOS
- * SPDX-License-Identifier: AGPL-3.0-or-later
- *
- * In-process cache for Klavis Strata `createStrata` responses.
- *
- * Conversation creation in `/chat` was blocking on a Worker-proxied
- * `klavisClient.createStrata` round-trip every time the user had any
- * managed Klavis app connected. This cache stores the (immutable) JSON
- * metadata returned by `createStrata` so that subsequent chats with the
- * same `(browserosId, enabled-server-set)` skip the round-trip entirely.
- *
- * It does NOT cache live MCP client connections — only URL/id metadata.
- * Per-session MCP clients continue to be opened and closed by
- * `AiSdkAgent.create` / `dispose` exactly as before, which makes the
- * cache safe across concurrent chats by construction.
- */
-
-import type {
-  KlavisClient,
-  StrataCreateResponse,
-} from '../../../lib/clients/klavis/klavis-client'
-import { logger } from '../../../lib/logger'
-
-const DEFAULT_TTL_MS = 60 * 60 * 1000
-
-interface CacheEntry {
-  strataServerUrl: string
-  strataId: string
-  addedServers: string[]
-  serverKey: string
-  expiresAt: number
-}
-
-function normalizeServers(servers: readonly string[]): string {
-  return [...new Set(servers)].sort().join(',')
-}
-
-function keyOf(browserosId: string, normalized: string): string {
-  // xxhash64 → 16 hex chars, fixed width. Birthday-bound collision risk
-  // for our scale (<10k entries) is ~5e-15; we additionally verify
-  // serverKey on read so collisions cannot affect correctness.
-  const hash = Bun.hash(normalized).toString(16).padStart(16, '0')
-  return `${browserosId}|${hash}`
-}
-
-export class KlavisStrataCache {
-  private entries = new Map<string, Promise<CacheEntry>>()
-
-  constructor(private ttlMs: number = DEFAULT_TTL_MS) {}
-
-  async getOrFetch(
-    client: KlavisClient,
-    browserosId: string,
-    servers: readonly string[],
-  ): Promise<StrataCreateResponse> {
-    const normalized = normalizeServers(servers)
-    const key = keyOf(browserosId, normalized)
-    const existing = this.entries.get(key)
-
-    if (existing) {
-      const resolved = await existing.catch(() => null)
-      if (
-        resolved &&
-        resolved.serverKey === normalized &&
-        Date.now() < resolved.expiresAt
-      ) {
-        logger.debug('Klavis strata cache hit', { key })
-        return this.toResponse(resolved)
-      }
-      // Stale/collision/rejected — evict, but only if we're the rightful
-      // evictor (a racing caller may have already replaced this slot).
-      if (this.entries.get(key) === existing) {
-        this.entries.delete(key)
-      }
-    }
-
-    logger.debug('Klavis strata cache miss', {
-      key,
-      serverCount: servers.length,
-    })
-    const inflight = this.fetch(client, browserosId, servers, normalized)
-    this.entries.set(key, inflight)
-
-    try {
-      return this.toResponse(await inflight)
-    } catch (err) {
-      // Identity-check: only drop OUR entry. A racing invalidate() may have
-      // already removed it, or a racing miss may have inserted a new one
-      // that we must not clobber.
-      if (this.entries.get(key) === inflight) {
-        this.entries.delete(key)
-      }
-      throw err
-    }
-  }
-
-  invalidate(browserosId: string): void {
-    const prefix = `${browserosId}|`
-    let dropped = 0
-    for (const key of this.entries.keys()) {
-      if (key.startsWith(prefix)) {
-        this.entries.delete(key)
-        dropped++
-      }
-    }
-    if (dropped > 0) {
-      logger.debug('Klavis strata cache invalidated', {
-        browserosId: browserosId.slice(0, 12),
-        dropped,
-      })
-    }
-  }
-
-  clear(): void {
-    this.entries.clear()
-  }
-
-  private async fetch(
-    client: KlavisClient,
-    browserosId: string,
-    servers: readonly string[],
-    normalized: string,
-  ): Promise<CacheEntry> {
-    const result = await client.createStrata(browserosId, [...servers])
-    return {
-      strataServerUrl: result.strataServerUrl,
-      strataId: result.strataId,
-      addedServers: result.addedServers,
-      serverKey: normalized,
-      expiresAt: Date.now() + this.ttlMs,
-    }
-  }
-
-  private toResponse(entry: CacheEntry): StrataCreateResponse {
-    return {
-      strataServerUrl: entry.strataServerUrl,
-      strataId: entry.strataId,
-      addedServers: entry.addedServers,
-    }
-  }
-}
-
-export const klavisStrataCache = new KlavisStrataCache()

packages/browseros-agent/apps/server/src/api/services/mcp/mcp-server.ts

@@ -8,11 +8,11 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { SetLevelRequestSchema } from '@modelcontextprotocol/sdk/types.js'
 import type { Browser } from '../../../browser/browser'
 import type { ToolRegistry } from '../../../tools/tool-registry'
+import { MCP_INSTRUCTIONS } from './mcp-prompt'
 import {
   type KlavisProxyHandle,
   registerKlavisTools,
-} from '../klavis/strata-proxy'
-import { MCP_INSTRUCTIONS } from './mcp-prompt'
+} from './register-klavis-mcp'
 import { registerTools } from './register-mcp'
 
 export interface McpServiceDeps {

packages/browseros-agent/apps/server/src/api/services/mcp/register-klavis-mcp.ts

@@ -14,7 +14,6 @@ import type { KlavisClient } from '../../../lib/clients/klavis/klavis-client'
 import { OAUTH_MCP_SERVERS } from '../../../lib/clients/klavis/oauth-mcp-servers'
 import { logger } from '../../../lib/logger'
 import { metrics } from '../../../lib/metrics'
-import { klavisStrataCache } from './strata-cache'
 
 function withTimeout<T>(promise: Promise<T>, label: string): Promise<T> {
   let timerId: ReturnType<typeof setTimeout> | undefined
@@ -50,8 +49,7 @@ export async function connectKlavisProxy(
   // even unauthenticated ones (Klavis handles auth prompts on call)
   const allServers = OAUTH_MCP_SERVERS.map((s) => s.name)
 
-  const strata = await klavisStrataCache.getOrFetch(
-    deps.klavisClient,
+  const strata = await deps.klavisClient.createStrata(
     deps.browserosId,
     allServers,
   )

packages/browseros-agent/apps/server/src/api/types.ts

@@ -102,3 +102,87 @@ export interface HttpServerConfig {
 
   onShutdown?: () => void
 }
+
+// Graph request schemas
+export const CreateGraphRequestSchema = z.object({
+  query: z.string().min(1, 'Query cannot be empty'),
+})
+
+export type CreateGraphRequest = z.infer<typeof CreateGraphRequestSchema>
+
+export const UpdateGraphRequestSchema = z.object({
+  query: z.string().min(1, 'Query cannot be empty'),
+})
+
+export type UpdateGraphRequest = z.infer<typeof UpdateGraphRequestSchema>
+
+// Run graph request - similar to ChatRequest, needs provider config for Agent SDK
+export const RunGraphRequestSchema = AgentLLMConfigSchema.extend({
+  browserContext: BrowserContextSchema.optional(),
+})
+
+export type RunGraphRequest = z.infer<typeof RunGraphRequestSchema>
+
+// Workflow graph schemas (matching codegen-service)
+export const WorkflowNodeTypeSchema = z.enum([
+  'start',
+  'end',
+  'nav',
+  'act',
+  'extract',
+  'verify',
+  'decision',
+  'loop',
+  'fork',
+  'join',
+])
+
+export type WorkflowNodeType = z.infer<typeof WorkflowNodeTypeSchema>
+
+export const WorkflowNodeSchema = z.object({
+  id: z.string(),
+  type: WorkflowNodeTypeSchema,
+  data: z.object({ label: z.string() }),
+})
+
+export type WorkflowNode = z.infer<typeof WorkflowNodeSchema>
+
+export const WorkflowEdgeSchema = z.object({
+  id: z.string(),
+  source: z.string(),
+  target: z.string(),
+})
+
+export type WorkflowEdge = z.infer<typeof WorkflowEdgeSchema>
+
+export const WorkflowGraphSchema = z.object({
+  nodes: z.array(WorkflowNodeSchema),
+  edges: z.array(WorkflowEdgeSchema),
+})
+
+export type WorkflowGraph = z.infer<typeof WorkflowGraphSchema>
+
+export interface GraphSession {
+  id: string
+  code: string
+  graph: WorkflowGraph | null
+  createdAt: Date
+}
+
+// Codegen service response schema for GET /api/code/:id
+export const CodegenGetResponseSchema = z.object({
+  code: z.string(),
+  graph: WorkflowGraphSchema.nullable(),
+  createdAt: z.string().optional(),
+})
+
+export type CodegenGetResponse = z.infer<typeof CodegenGetResponseSchema>
+
+// Metadata schema for finish events from codegen service
+export const CodegenFinishMetadataSchema = z.object({
+  codeId: z.string().optional(),
+  code: z.string().optional(),
+  graph: WorkflowGraphSchema.nullable().optional(),
+})
+
+export type CodegenFinishMetadata = z.infer<typeof CodegenFinishMetadataSchema>

packages/browseros-agent/apps/server/src/graph/executor.ts

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2025 BrowserOS
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import { mkdir, rm } from 'node:fs/promises'
+import path from 'node:path'
+import type { BrowserContext } from '@browseros/shared/schemas/browser-context'
+import type { LLMConfig, UIMessageStreamEvent } from '@browseros-ai/agent-sdk'
+import { Agent } from '@browseros-ai/agent-sdk'
+import { z } from 'zod'
+import { logger } from '../lib/logger'
+
+//TODO: nikhil - Fix this with new bun package logic
+// Expose zod globally for generated graph code. The codegen service generates code
+// that uses `z` for schema validation, but transformCodeForExecution strips all imports
+// since dependencies can't be resolved in dynamically imported files (especially in
+// compiled binaries where modules are bundled). By exposing `z` as a global, the
+// generated code can reference it without an import statement.
+;(globalThis as unknown as Record<string, unknown>).z = z
+
+export interface ExecutorOptions {
+  serverUrl: string
+  llmConfig?: LLMConfig
+  browserContext?: BrowserContext
+  onProgress: (event: UIMessageStreamEvent) => void
+  signal?: AbortSignal
+}
+
+export interface ExecutorResult {
+  success: boolean
+  result?: unknown
+  error?: string
+}
+
+/**
+ * Executes generated graph code using the Agent SDK.
+ *
+ * @param code - Generated code from codegen service
+ * @param sessionId - Unique session ID for this execution
+ * @param tempDir - Base temp directory for execution files
+ * @param options - Execution options (serverUrl, llmConfig, onProgress, signal)
+ */
+export async function executeGraph(
+  code: string,
+  sessionId: string,
+  tempDir: string,
+  options: ExecutorOptions,
+): Promise<ExecutorResult> {
+  const execDir = path.join(tempDir, 'graph', sessionId)
+
+  try {
+    // Check if aborted before starting
+    if (options.signal?.aborted) {
+      return { success: false, error: 'Execution aborted' }
+    }
+
+    // Create execution directory
+    await mkdir(execDir, { recursive: true })
+
+    // Transform code: remove import statements (Agent is passed directly)
+    const transformedCode = transformCodeForExecution(code)
+
+    // Write code to file
+    const codePath = path.join(execDir, 'graph.ts')
+    await Bun.write(codePath, transformedCode)
+
+    logger.debug(`Wrote graph code to ${codePath}`)
+
+    // Create Agent instance with progress callback (auto-disposed on scope exit)
+    await using agent = new Agent({
+      url: options.serverUrl,
+      llm: options.llmConfig,
+      onProgress: options.onProgress,
+      signal: options.signal,
+      browserContext: options.browserContext,
+      stateful: true,
+    })
+
+    // Dynamic import with cache-busting (Bun caches imports by path)
+    const module = await import(`${codePath}?t=${Date.now()}`)
+
+    if (typeof module.run !== 'function') {
+      throw new Error('Generated code must export a "run" function')
+    }
+
+    let abortHandler: (() => void) | undefined
+    try {
+      // Only use Promise.race if we have a signal to listen to
+      const result = options.signal
+        ? await Promise.race([
+            module.run(agent),
+            new Promise<never>((_, reject) => {
+              abortHandler = () => reject(new Error('Execution aborted'))
+              options.signal?.addEventListener('abort', abortHandler, {
+                once: true,
+              })
+            }),
+          ])
+        : await module.run(agent)
+
+      return { success: true, result }
+    } finally {
+      if (abortHandler && options.signal) {
+        options.signal.removeEventListener('abort', abortHandler)
+      }
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    logger.error(`Graph execution failed: ${errorMessage}`)
+    return { success: false, error: errorMessage }
+  }
+}
+
+export function transformCodeForExecution(code: string): string {
+  // Remove multi-line imports: import { ... } from 'any-package'
+  let result = code.replace(
+    /^\s*import\s+(?:type\s+)?\{[\s\S]*?\}\s*from\s*['"][^'"\n]*['"].*$/gm,
+    '',
+  )
+
+  // Remove single-line imports: import X from '...', import 'side-effect', etc.
+  result = result.replace(/^\s*import\s+.*['"][^'"\n]*['"].*$/gm, '')
+
+  return result
+}
+
+/**
+ * Cleans up execution files for a session.
+ */
+export async function cleanupExecution(
+  sessionId: string,
+  tempDir: string,
+): Promise<void> {
+  const execDir = path.join(tempDir, 'graph', sessionId)
+
+  try {
+    await rm(execDir, { recursive: true, force: true })
+    logger.debug(`Cleaned up execution directory: ${execDir}`)
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    logger.warn(`Failed to cleanup execution directory: ${errorMessage}`)
+  }
+}

packages/browseros-agent/apps/server/src/lib/clients/klavis/klavis-client.ts

@@ -145,14 +145,16 @@ export class KlavisClient {
     })
   }
 
-  async deleteServersFromStrata(
-    strataId: string,
-    servers: string[],
-  ): Promise<void> {
-    const query = servers.map(encodeURIComponent).join(',')
+  /**
+   * Remove a server from a Strata instance
+   * Flow: createStrata(server) to get strataId → DELETE /strata/{strataId}/servers?servers=X
+   */
+  async removeServer(userId: string, serverName: string): Promise<void> {
+    // createStrata to get strataId (passing same server ensures it exists)
+    const strata = await this.createStrata(userId, [serverName])
     await this.request(
       'DELETE',
-      `/mcp-server/strata/${strataId}/servers?servers=${query}`,
+      `/mcp-server/strata/${strata.strataId}/servers?servers=${encodeURIComponent(serverName)}`,
     )
   }
 }

packages/browseros-agent/apps/server/src/tools/browseros-info.ts

@@ -12,7 +12,8 @@ BrowserOS is an AI-native browser built on Chromium that turns plain English int
 ## Modes
 
 - **Chat Mode** — Ask questions about any webpage: summarize articles, extract data, translate content. Activate with Option+K. Works with any LLM, including local models.
-- **Agent Mode** — Describe a task and the agent executes it: clicking, typing, navigating, filling forms, extracting data, and multi-step browser tasks. Best with Claude Opus 4.5 or Kimi K2.5.
+- **Agent Mode** — Describe a task and the agent executes it: clicking, typing, navigating, filling forms, extracting data, multi-step workflows. Best with Claude Opus 4.5 or Kimi K2.5.
+- **Graph Mode (Workflows)** — Build visual workflow graphs for repeatable, reliable automations with parallel execution, loops, and conditionals.
 
 ---
 
@@ -22,12 +23,16 @@ BrowserOS is an AI-native browser built on Chromium that turns plain English int
 Connect your preferred AI provider or run models locally. Supported providers: Gemini (free tier), Claude/Anthropic, OpenAI, OpenRouter (500+ models). Local options: Ollama, LM Studio. Configure at chrome://browseros/settings.
 Learn more: https://docs.browseros.com/features/bring-your-own-llm
 
+### Workflows
+Convert complex browser tasks into repeatable visual automations. Describe the task, the agent generates a workflow graph, refine it through conversation, then run it on demand. Ideal for data entry, outreach, price monitoring, bulk operations.
+Learn more: https://docs.browseros.com/features/workflows
+
 ### Scheduled Tasks
 Automate tasks on a schedule — daily, hourly, or every few minutes. Runs in a background window without interrupting your work. Use cases: morning briefings, LinkedIn automation, price monitoring. Requires BrowserOS to be open.
 Learn more: https://docs.browseros.com/features/scheduled-tasks
 
 ### Filesystem Access
-Grant the agent controlled access to a local folder to read files, write reports, and run shell commands. Sandboxed — cannot access parent directories. Combine web research with local file creation in a single task.
+Grant the agent controlled access to a local folder to read files, write reports, and run shell commands. Sandboxed — cannot access parent directories. Combine web research with local file creation in a single workflow.
 Learn more: https://docs.browseros.com/features/cowork
 
 ### Connect Apps (MCPs)
@@ -49,6 +54,7 @@ Learn more: https://docs.browseros.com/features/ad-blocking`
 const VALID_TOPICS = [
   'overview',
   'bring-your-own-llm',
+  'workflows',
   'scheduled-tasks',
   'filesystem-access',
   'connect-apps',
@@ -61,8 +67,9 @@ const TOPIC_SECTIONS: Record<string, { start: string; end?: string }> = {
   overview: { start: '# BrowserOS', end: '## Core Features' },
   'bring-your-own-llm': {
     start: '### Bring Your Own LLM',
-    end: '### Scheduled Tasks',
+    end: '### Workflows',
   },
+  workflows: { start: '### Workflows', end: '### Scheduled Tasks' },
   'scheduled-tasks': {
     start: '### Scheduled Tasks',
     end: '### Filesystem Access',

packages/browseros-agent/apps/server/tests/api/routes/klavis.test.ts

@@ -3,17 +3,12 @@
  * Copyright 2025 BrowserOS
  */
 
-import { afterEach, beforeEach, describe, it } from 'bun:test'
+import { afterEach, describe, it } from 'bun:test'
 import assert from 'node:assert'
 import { createKlavisRoutes } from '../../../src/api/routes/klavis'
-import { klavisStrataCache } from '../../../src/api/services/klavis/strata-cache'
 
 const originalFetch = globalThis.fetch
 
-beforeEach(() => {
-  klavisStrataCache.clear()
-})
-
 afterEach(() => {
   globalThis.fetch = originalFetch
 })

packages/browseros-agent/apps/server/tests/api/services/klavis/strata-cache.test.ts

@@ -1,163 +0,0 @@
-/**
- * @license
- * Copyright 2025 BrowserOS
- */
-
-import { describe, expect, it } from 'bun:test'
-import { KlavisStrataCache } from '../../../../src/api/services/klavis/strata-cache'
-import type {
-  KlavisClient,
-  StrataCreateResponse,
-} from '../../../../src/lib/clients/klavis/klavis-client'
-
-class StubKlavisClient {
-  callCount = 0
-  delayMs = 0
-  shouldThrowOnce = false
-  lastServers: string[] | null = null
-
-  async createStrata(
-    userId: string,
-    servers: string[],
-  ): Promise<StrataCreateResponse> {
-    this.callCount++
-    this.lastServers = servers
-    if (this.shouldThrowOnce) {
-      this.shouldThrowOnce = false
-      throw new Error('boom')
-    }
-    if (this.delayMs > 0) {
-      await new Promise((r) => setTimeout(r, this.delayMs))
-    }
-    return {
-      strataServerUrl: `https://strata.test/${userId}/${servers.join('-')}`,
-      strataId: `strata_${userId}`,
-      addedServers: servers,
-    }
-  }
-}
-
-const asClient = (stub: StubKlavisClient): KlavisClient =>
-  stub as unknown as KlavisClient
-
-describe('KlavisStrataCache', () => {
-  it('cache hit returns the same value without re-calling the client', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    const a = await cache.getOrFetch(asClient(client), 'user1', ['Gmail'])
-    const b = await cache.getOrFetch(asClient(client), 'user1', ['Gmail'])
-    expect(client.callCount).toBe(1)
-    expect(a.strataServerUrl).toBe(b.strataServerUrl)
-    expect(a.strataId).toBe(b.strataId)
-  })
-
-  it('normalizes server order — [Gmail, Linear] === [Linear, Gmail]', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail', 'Linear'])
-    await cache.getOrFetch(asClient(client), 'u', ['Linear', 'Gmail'])
-    expect(client.callCount).toBe(1)
-  })
-
-  it('dedupes duplicate server names within one call', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail', 'Gmail'])
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    expect(client.callCount).toBe(1)
-  })
-
-  it('different user gets a separate cache entry', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'userA', ['Gmail'])
-    await cache.getOrFetch(asClient(client), 'userB', ['Gmail'])
-    expect(client.callCount).toBe(2)
-  })
-
-  it('different server set (same user) gets a separate cache entry', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail', 'Linear'])
-    expect(client.callCount).toBe(2)
-  })
-
-  it('concurrent misses share a single in-flight Promise', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    client.delayMs = 30
-    const [a, b, c] = await Promise.all([
-      cache.getOrFetch(asClient(client), 'u', ['Gmail']),
-      cache.getOrFetch(asClient(client), 'u', ['Gmail']),
-      cache.getOrFetch(asClient(client), 'u', ['Gmail']),
-    ])
-    expect(client.callCount).toBe(1)
-    expect(a.strataId).toBe(b.strataId)
-    expect(b.strataId).toBe(c.strataId)
-  })
-
-  it('TTL expiry triggers a fresh fetch', async () => {
-    const cache = new KlavisStrataCache(10) // 10 ms TTL
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    await new Promise((r) => setTimeout(r, 25))
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    expect(client.callCount).toBe(2)
-  })
-
-  it('invalidate(userA) drops only userA entries', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'userA', ['Gmail'])
-    await cache.getOrFetch(asClient(client), 'userB', ['Gmail'])
-    cache.invalidate('userA')
-    await cache.getOrFetch(asClient(client), 'userA', ['Gmail'])
-    await cache.getOrFetch(asClient(client), 'userB', ['Gmail'])
-    expect(client.callCount).toBe(3) // userA: cold + cold, userB: cold + hit
-  })
-
-  it('invalidate while a fetch is in flight does not store the result', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    client.delayMs = 30
-    const inflight = cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    cache.invalidate('u')
-    const result = await inflight
-    expect(result.strataId).toBe('strata_u')
-    // Next call should not see the post-invalidate write — must re-fetch.
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    expect(client.callCount).toBe(2)
-  })
-
-  it('rejected fetches do not poison the cache', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    client.shouldThrowOnce = true
-    await expect(
-      cache.getOrFetch(asClient(client), 'u', ['Gmail']),
-    ).rejects.toThrow('boom')
-    await cache.getOrFetch(asClient(client), 'u', ['Gmail'])
-    expect(client.callCount).toBe(2)
-  })
-
-  it('clear() drops all entries', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    await cache.getOrFetch(asClient(client), 'userA', ['Gmail'])
-    await cache.getOrFetch(asClient(client), 'userB', ['Linear'])
-    cache.clear()
-    await cache.getOrFetch(asClient(client), 'userA', ['Gmail'])
-    await cache.getOrFetch(asClient(client), 'userB', ['Linear'])
-    expect(client.callCount).toBe(4)
-  })
-
-  it('passes a defensive copy of the servers array to the client', async () => {
-    const cache = new KlavisStrataCache()
-    const client = new StubKlavisClient()
-    const input: readonly string[] = ['Gmail', 'Linear']
-    await cache.getOrFetch(asClient(client), 'u', input)
-    expect(client.lastServers).not.toBe(input)
-    expect(client.lastServers).toEqual(['Gmail', 'Linear'])
-  })
-})

packages/browseros-agent/apps/server/tests/build.test.ts

@@ -156,6 +156,28 @@ describe('server build', () => {
     assert.strictEqual(versionOutput.trim(), expectedVersion)
   }, 300_000)
 
+  it('keeps compile-only on the strict production validation path', async () => {
+    resetProdEnvToTemplate()
+
+    const build = Bun.spawn(
+      ['bun', buildScript, `--target=${target.id}`, '--compile-only'],
+      {
+        cwd: rootDir,
+        stdout: 'pipe',
+        stderr: 'pipe',
+        env: buildEnv({}, PROD_SECRET_KEYS),
+      },
+    )
+    const buildExit = await build.exited
+    const stderr = await new Response(build.stderr).text()
+
+    assert.notStrictEqual(buildExit, 0, 'Compile-only build should fail')
+    assert.match(stderr, /Production build requires variables:/)
+    assert.match(stderr, /CODEGEN_SERVICE_URL/)
+    assert.match(stderr, /POSTHOG_API_KEY/)
+    assert.match(stderr, /SENTRY_DSN/)
+  }, 300_000)
+
   it('archives CI builds without R2 config or production env secrets', async () => {
     resetProdEnvToTemplate()
     rmSync(zipPath, { force: true })

packages/browseros-agent/apps/server/tests/graph/executor.test.ts

@@ -0,0 +1,285 @@
+/**
+ * @license
+ * Copyright 2025 BrowserOS
+ */
+
+import { describe, it } from 'bun:test'
+import assert from 'node:assert'
+
+import { transformCodeForExecution } from '../../src/graph/executor'
+
+describe('transformCodeForExecution', () => {
+  describe('single-line imports', () => {
+    it('removes default import', () => {
+      const code = `import foo from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes named import', () => {
+      const code = `import { foo } from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes multiple named imports', () => {
+      const code = `import { foo, bar, baz } from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes namespace import', () => {
+      const code = `import * as pkg from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes side-effect import', () => {
+      const code = `import 'side-effect'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes default + named import', () => {
+      const code = `import foo, { bar } from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes import with alias', () => {
+      const code = `import { foo as f } from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('type imports', () => {
+    it('removes type import', () => {
+      const code = `import type { Foo } from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes type default import', () => {
+      const code = `import type Foo from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes inline type specifier', () => {
+      const code = `import { type Foo, bar } from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('multi-line imports', () => {
+    it('removes multi-line named imports', () => {
+      const code = `import {
+  foo,
+  bar,
+} from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes multi-line type imports', () => {
+      const code = `import type {
+  Foo,
+  Bar,
+} from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes multi-line imports with aliases', () => {
+      const code = `import {
+  foo as f,
+  bar as b,
+} from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes deeply nested multi-line imports', () => {
+      const code = `import {
+  foo,
+  bar,
+  baz,
+  qux,
+} from '@scoped/package-name'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('quote styles', () => {
+    it('handles single quotes', () => {
+      const code = `import foo from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('handles double quotes', () => {
+      const code = `import foo from "pkg"
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('multiple imports', () => {
+    it('removes all imports from different packages', () => {
+      const code = `import { z } from 'zod'
+import { Agent } from '@browseros-ai/agent-sdk'
+import type { Config } from './types'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes mixed single and multi-line imports', () => {
+      const code = `import foo from 'foo'
+import {
+  bar,
+  baz,
+} from 'bar'
+import qux from 'qux'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('indentation', () => {
+    it('removes indented imports', () => {
+      const code = `  import foo from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes tab-indented imports', () => {
+      const code = `\timport foo from 'pkg'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('preserves non-import code', () => {
+    it('preserves all code after imports', () => {
+      const code = `import foo from 'pkg'
+
+export async function run(agent) {
+  await agent.navigate('https://example.com')
+  return 'done'
+}`
+      const result = transformCodeForExecution(code)
+      assert.ok(result.includes('export async function run(agent)'))
+      assert.ok(result.includes("await agent.navigate('https://example.com')"))
+      assert.ok(result.includes("return 'done'"))
+      assert.ok(!result.includes('import'))
+    })
+
+    it('preserves code with import-like strings', () => {
+      const code = `import foo from 'pkg'
+const str = "import { x } from 'y'"
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.ok(result.includes(`const str = "import { x } from 'y'"`))
+      assert.ok(result.includes('const x = 1'))
+    })
+
+    it('preserves dynamic imports', () => {
+      const code = `import foo from 'pkg'
+const mod = await import('./dynamic')
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.ok(result.includes("const mod = await import('./dynamic')"))
+      assert.ok(result.includes('const x = 1'))
+    })
+  })
+
+  describe('scoped packages', () => {
+    it('removes @scoped/package imports', () => {
+      const code = `import { Agent } from '@browseros-ai/agent-sdk'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes deeply scoped package imports', () => {
+      const code = `import { foo } from '@org/pkg/sub/path'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('relative imports', () => {
+    it('removes relative imports', () => {
+      const code = `import foo from './foo'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('removes parent directory imports', () => {
+      const code = `import foo from '../foo'
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+
+  describe('edge cases', () => {
+    it('handles empty code', () => {
+      const result = transformCodeForExecution('')
+      assert.strictEqual(result, '')
+    })
+
+    it('handles code with no imports', () => {
+      const code = `const x = 1
+const y = 2`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result, code)
+    })
+
+    it('handles code with only imports', () => {
+      const code = `import foo from 'foo'
+import bar from 'bar'`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), '')
+    })
+
+    it('handles imports with trailing semicolons', () => {
+      const code = `import foo from 'pkg';
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+
+    it('handles imports with trailing comments', () => {
+      const code = `import foo from 'pkg' // comment
+const x = 1`
+      const result = transformCodeForExecution(code)
+      assert.strictEqual(result.trim(), 'const x = 1')
+    })
+  })
+})

packages/browseros-agent/bun.lock

@@ -23,7 +23,7 @@
     },
     "apps/agent": {
       "name": "@browseros/agent",
-      "version": "0.0.99",
+      "version": "0.0.98",
       "dependencies": {
         "@ai-sdk/react": "^3.0.96",
         "@browseros/server": "workspace:*",
@@ -152,7 +152,7 @@
     },
     "apps/server": {
       "name": "@browseros/server",
-      "version": "0.0.82",
+      "version": "0.0.80",
       "bin": {
         "browseros-server": "./src/index.ts",
       },

packages/browseros-agent/docs/events.md

@@ -141,6 +141,21 @@ Prefix: `browseros.native.extension.`
 | `settings.scheduled_task.cancelled` | — | Running task was cancelled |
 | `settings.scheduled_task.retried` | — | Task run was retried |
 
+### Settings — Workflows
+
+| Event | Properties | Description |
+|-------|-----------|-------------|
+| `settings.graph.created` | — | New workflow graph created |
+| `settings.graph.saved` | — | Workflow graph saved |
+| `settings.graph.updated` | — | Workflow graph updated |
+| `settings.graph.message.like` | — | Workflow message liked |
+| `settings.graph.message.dislike` | — | Workflow message disliked |
+| `settings.workflow.deleted` | — | Workflow deleted |
+| `settings.workflow.run_started` | — | Workflow run started |
+| `settings.workflow.run_stopped` | — | Workflow run stopped |
+| `settings.workflow.run_retried` | — | Workflow run retried |
+| `settings.workflow.run_completed` | — | Workflow run completed |
+
 ### Onboarding
 
 | Event | Properties | Description |

packages/browseros-agent/scripts/build/server/cli.ts

@@ -21,6 +21,10 @@ export function parseBuildArgs(argv: string[]): BuildArgs {
     )
     .option('--upload', 'Upload artifact zips to R2')
     .option('--no-upload', 'Skip zip upload to R2')
+    .option(
+      '--compile-only',
+      'Compile binaries only (skip artifact packaging, R2 staging, and upload)',
+    )
     .option(
       '--ci',
       'Build local release zip artifacts for CI without R2 and without requiring production env secrets',
@@ -30,10 +34,15 @@ export function parseBuildArgs(argv: string[]): BuildArgs {
     target: string
     manifest: string
     upload: boolean
+    compileOnly: boolean
     ci: boolean
   }>()
 
+  const compileOnly = options.compileOnly ?? false
   const ci = options.ci ?? false
+  if (ci && compileOnly) {
+    throw new Error('--ci cannot be combined with --compile-only')
+  }
   if (ci && options.upload) {
     throw new Error('--ci cannot be combined with --upload')
   }
@@ -41,7 +50,8 @@ export function parseBuildArgs(argv: string[]): BuildArgs {
   return {
     targets: resolveTargets(options.target),
     manifestPath: options.manifest,
-    upload: ci ? false : (options.upload ?? true),
+    upload: ci || compileOnly ? false : (options.upload ?? true),
+    compileOnly,
     ci,
   }
 }

packages/browseros-agent/scripts/build/server/compile.ts

@@ -1,7 +1,6 @@
 import { mkdirSync, rmSync } from 'node:fs'
 import { join } from 'node:path'
 
-import { log } from '../log'
 import { wasmBinaryPlugin } from '../plugins/wasm-binary'
 import { runCommand } from './command'
 import type { BuildTarget, CompiledServerBinary } from './types'
@@ -53,7 +52,6 @@ async function bundleServer(
 async function compileTarget(
   target: BuildTarget,
   env: NodeJS.ProcessEnv,
-  ci: boolean,
 ): Promise<string> {
   const binaryPath = compiledBinaryPath(target)
   const args = [
@@ -68,15 +66,11 @@ async function compileTarget(
   await runCommand('bun', args, env)
 
   if (target.os === 'windows') {
-    if (ci) {
-      log.warn('Skipping Windows exe metadata patching in CI mode')
-    } else {
-      await runCommand(
-        'bun',
-        ['scripts/patch-windows-exe.ts', binaryPath],
-        process.env,
-      )
-    }
+    await runCommand(
+      'bun',
+      ['scripts/patch-windows-exe.ts', binaryPath],
+      process.env,
+    )
   }
 
   return binaryPath
@@ -87,16 +81,14 @@ export async function compileServerBinaries(
   envVars: Record<string, string>,
   processEnv: NodeJS.ProcessEnv,
   version: string,
-  options?: { ci?: boolean },
 ): Promise<CompiledServerBinary[]> {
-  const ci = options?.ci ?? false
   rmSync(TMP_ROOT, { recursive: true, force: true })
   mkdirSync(BINARIES_DIR, { recursive: true })
   await bundleServer(envVars, version)
 
   const compiled: CompiledServerBinary[] = []
   for (const target of targets) {
-    const binaryPath = await compileTarget(target, processEnv, ci)
+    const binaryPath = await compileTarget(target, processEnv)
     compiled.push({ target, binaryPath })
   }
 

packages/browseros-agent/scripts/build/server/config.ts

@@ -75,6 +75,7 @@ function validateProductionEnv(envVars: Record<string, string>): void {
 }
 
 export interface LoadBuildConfigOptions {
+  compileOnly?: boolean
   ci?: boolean
 }
 
@@ -94,7 +95,7 @@ export function loadBuildConfig(
     ...process.env,
   }
 
-  if (options.ci) {
+  if (options.compileOnly || options.ci) {
     return { version: readServerVersion(rootDir), envVars, processEnv }
   }
 

packages/browseros-agent/scripts/build/server/orchestrator.ts

@@ -10,8 +10,11 @@ import { getTargetRules, loadManifest } from './manifest'
 import { createR2Client } from './r2'
 import { stageCompiledArtifact, stageTargetArtifact } from './stage'
 
-function buildModeLabel(ci: boolean): string {
-  return ci ? 'ci' : 'full'
+function buildModeLabel(argv: { compileOnly: boolean; ci: boolean }): string {
+  if (argv.ci) {
+    return 'ci'
+  }
+  return argv.compileOnly ? 'compile-only' : 'full'
 }
 
 export async function runProdResourceBuild(argv: string[]): Promise<void> {
@@ -20,18 +23,20 @@ export async function runProdResourceBuild(argv: string[]): Promise<void> {
 
   const args = parseBuildArgs(argv)
 
-  const buildConfig = loadBuildConfig(rootDir, { ci: args.ci })
+  const buildConfig = loadBuildConfig(rootDir, {
+    compileOnly: args.compileOnly,
+    ci: args.ci,
+  })
 
   log.header(`Building BrowserOS server artifacts v${buildConfig.version}`)
   log.info(`Targets: ${args.targets.map((target) => target.id).join(', ')}`)
-  log.info(`Mode: ${buildModeLabel(args.ci)}`)
+  log.info(`Mode: ${buildModeLabel(args)}`)
 
   const compiled = await compileServerBinaries(
     args.targets,
     buildConfig.envVars,
     buildConfig.processEnv,
     buildConfig.version,
-    { ci: args.ci },
   )
 
   if (args.ci) {
@@ -58,6 +63,14 @@ export async function runProdResourceBuild(argv: string[]): Promise<void> {
     return
   }
 
+  if (args.compileOnly) {
+    log.done('Compile-only build completed')
+    for (const binary of compiled) {
+      log.info(`${binary.target.id}: ${binary.binaryPath}`)
+    }
+    return
+  }
+
   const manifestPath = resolve(rootDir, args.manifestPath)
   if (!existsSync(manifestPath)) {
     throw new Error(`Manifest not found: ${manifestPath}`)

packages/browseros-agent/scripts/build/server/types.ts

@@ -21,6 +21,7 @@ export interface BuildArgs {
   targets: BuildTarget[]
   manifestPath: string
   upload: boolean
+  compileOnly: boolean
   ci: boolean
 }
 

packages/browseros/build/cli/build.py

@@ -402,11 +402,9 @@ def main(
         "upload": upload,
     }
 
-    # Resolve build context (CONFIG mode or DIRECT mode).
-    # Returns one Context per architecture — single-element for normal
-    # builds, multi-element when YAML declares `architecture: [x64, arm64]`.
+    # Resolve build context (CONFIG mode or DIRECT mode)
     try:
-        arch_ctxs = resolve_config(cli_args, config_data)
+        ctx = resolve_config(cli_args, config_data)
     except ValueError as e:
         log_error(str(e))
         raise typer.Exit(1)
@@ -461,40 +459,20 @@ def main(
         os.environ["DEPOT_TOOLS_WIN_TOOLCHAIN"] = "0"
         log_info("Set DEPOT_TOOLS_WIN_TOOLCHAIN=0 for Windows build")
 
-    # Print build summary using the first context — versions and paths
-    # are identical across per-arch contexts. Architecture is logged again
-    # inside the loop below for multi-arch runs.
-    summary_ctx = arch_ctxs[0]
     log_info(f"📍 Root: {root_dir}")
-    log_info(f"📍 Chromium: {summary_ctx.chromium_src}")
-    if len(arch_ctxs) > 1:
-        log_info(
-            f"📍 Architectures: {[c.architecture for c in arch_ctxs]} (multi-arch loop)"
-        )
-    else:
-        log_info(f"📍 Architecture: {summary_ctx.architecture}")
-    log_info(f"📍 Build type: {summary_ctx.build_type}")
-    log_info(f"📍 Semantic version: {summary_ctx.semantic_version}")
-    log_info(f"📍 Chromium version: {summary_ctx.chromium_version}")
-    log_info(f"📍 Build offset: {summary_ctx.browseros_build_offset}")
+    log_info(f"📍 Chromium: {ctx.chromium_src}")
+    log_info(f"📍 Architecture: {ctx.architecture}")
+    log_info(f"📍 Build type: {ctx.build_type}")
+    log_info(f"📍 Output: {ctx.out_dir}")
+    log_info(f"📍 Semantic version: {ctx.semantic_version}")
+    log_info(f"📍 Chromium version: {ctx.chromium_version}")
+    log_info(f"📍 Build offset: {ctx.browseros_build_offset}")
     log_info(f"📍 Pipeline: {' → '.join(pipeline)}")
     log_info("=" * 70)
 
+    # Set notification context for OS and architecture
     os_name = "macOS" if IS_MACOS() else "Windows" if IS_WINDOWS() else "Linux"
+    set_build_context(os_name, ctx.architecture)
 
-    # Execute the pipeline once per architecture. Modules see a normal
-    # single-arch ctx; the runner is the only thing that knows about the
-    # multi-arch loop.
-    for i, arch_ctx in enumerate(arch_ctxs, start=1):
-        if len(arch_ctxs) > 1:
-            log_info("\n" + "#" * 70)
-            log_info(
-                f"# Architecture {i}/{len(arch_ctxs)}: {arch_ctx.architecture}"
-            )
-            log_info(f"# Output: {arch_ctx.out_dir}")
-            log_info("#" * 70)
-
-        set_build_context(os_name, arch_ctx.architecture)
-        execute_pipeline(
-            arch_ctx, pipeline, AVAILABLE_MODULES, pipeline_name="build"
-        )
+    # Execute pipeline
+    execute_pipeline(ctx, pipeline, AVAILABLE_MODULES, pipeline_name="build")

packages/browseros/build/common/resolver.py

@@ -26,13 +26,11 @@ from .context import Context
 from .env import EnvConfig
 from .utils import get_platform_arch, log_info
 
-VALID_ARCHITECTURES = {"x64", "arm64", "universal"}
-
 
 def resolve_config(
     cli_args: Dict[str, Any],
     yaml_config: Optional[Dict[str, Any]] = None,
-) -> List[Context]:
+) -> Context:
     """Resolve build configuration - single entry point.
 
     Args:
@@ -40,9 +38,7 @@ def resolve_config(
         yaml_config: Optional YAML configuration (triggers CONFIG mode)
 
     Returns:
-        List of fully resolved Context objects. Single-element for the
-        common single-arch case; multi-element when YAML declares
-        `architecture: [x64, arm64]` (Linux multi-arch).
+        Fully resolved Context object
 
     Raises:
         ValueError: If required fields missing or invalid
@@ -63,7 +59,7 @@ def resolve_config(
 
 def _resolve_config_mode(
     yaml_config: Dict[str, Any], cli_args: Dict[str, Any]
-) -> List[Context]:
+) -> Context:
     """CONFIG MODE: YAML is base, CLI can override.
 
     Args:
@@ -71,7 +67,7 @@ def _resolve_config_mode(
         cli_args: CLI arguments (can override YAML values)
 
     Returns:
-        List of Contexts. One per architecture when YAML provides a list.
+        Context with values from YAML, optionally overridden by CLI
 
     Raises:
         ValueError: If required fields missing from both YAML and CLI
@@ -98,66 +94,41 @@ def _resolve_config_mode(
             f"Expected directory with Chromium source code"
         )
 
-    # architecture: CLI override > YAML > platform default.
-    # YAML may be a string OR a list (e.g. [x64, arm64]) — list form runs
-    # the entire pipeline once per arch.
-    cli_arch = cli_args.get("arch")
-    yaml_arch = build_section.get("architecture") or build_section.get("arch")
-
-    if cli_arch:
-        architectures = [cli_arch]
-        arch_source = "cli"
-    elif yaml_arch is not None:
-        architectures = yaml_arch if isinstance(yaml_arch, list) else [yaml_arch]
-        arch_source = "yaml"
-    else:
-        architectures = [get_platform_arch()]
+    # architecture: CLI override > YAML > platform default
+    architecture = (
+        cli_args.get("arch")
+        or build_section.get("architecture")
+        or build_section.get("arch")
+    )
+    arch_source = "cli" if cli_args.get("arch") else "yaml"
+    if not architecture:
+        architecture = get_platform_arch()
         arch_source = "default"
-        log_info(
-            f"CONFIG MODE: Using platform default architecture: {architectures[0]}"
-        )
-
-    for arch in architectures:
-        if arch not in VALID_ARCHITECTURES:
-            raise ValueError(
-                f"CONFIG MODE: invalid architecture '{arch}'. "
-                f"Valid: {sorted(VALID_ARCHITECTURES)}"
-            )
+        log_info(f"CONFIG MODE: Using platform default architecture: {architecture}")
 
     # build_type: CLI override > YAML > debug
     build_type = cli_args.get("build_type") or build_section.get("type", "debug")
     build_type_source = "cli" if cli_args.get("build_type") else "yaml"
 
     log_info(f"✓ CONFIG MODE: chromium_src={chromium_src} ({chromium_src_source})")
-    if len(architectures) > 1:
-        log_info(
-            f"✓ CONFIG MODE: architectures={architectures} ({arch_source}, multi-arch loop)"
-        )
-    else:
-        log_info(
-            f"✓ CONFIG MODE: architecture={architectures[0]} ({arch_source})"
-        )
+    log_info(f"✓ CONFIG MODE: architecture={architecture} ({arch_source})")
     log_info(f"✓ CONFIG MODE: build_type={build_type} ({build_type_source})")
 
-    return [
-        Context(
-            chromium_src=chromium_src,
-            architecture=arch,
-            build_type=build_type,
-        )
-        for arch in architectures
-    ]
+    return Context(
+        chromium_src=chromium_src,
+        architecture=architecture,
+        build_type=build_type,
+    )
 
 
-def _resolve_direct_mode(cli_args: Dict[str, Any]) -> List[Context]:
+def _resolve_direct_mode(cli_args: Dict[str, Any]) -> Context:
     """DIRECT MODE: CLI > Env > Defaults.
 
     Args:
         cli_args: CLI arguments (None if not provided by user)
 
     Returns:
-        Single-element list with the resolved Context. DIRECT mode is
-        always single-arch (CLI --arch is a scalar).
+        Context with resolved values
 
     Raises:
         ValueError: If chromium_src not provided
@@ -189,12 +160,6 @@ def _resolve_direct_mode(cli_args: Dict[str, Any]) -> List[Context]:
         architecture = get_platform_arch()
         log_info(f"DIRECT MODE: Using platform default architecture: {architecture}")
 
-    if architecture not in VALID_ARCHITECTURES:
-        raise ValueError(
-            f"DIRECT MODE: invalid architecture '{architecture}'. "
-            f"Valid: {sorted(VALID_ARCHITECTURES)}"
-        )
-
     # build_type: CLI > Default
     build_type = cli_args.get("build_type") or "debug"
 
@@ -202,13 +167,11 @@ def _resolve_direct_mode(cli_args: Dict[str, Any]) -> List[Context]:
     log_info(f"✓ DIRECT MODE: architecture={architecture} (cli/env/default)")
     log_info(f"✓ DIRECT MODE: build_type={build_type} (cli/default)")
 
-    return [
-        Context(
-            chromium_src=chromium_src,
-            architecture=architecture,
-            build_type=build_type,
-        )
-    ]
+    return Context(
+        chromium_src=chromium_src,
+        architecture=architecture,
+        build_type=build_type,
+    )
 
 
 def resolve_pipeline(

packages/browseros/build/config/package.linux.yaml

@@ -3,10 +3,7 @@
 # This config packages an already-built Linux application.
 # Use this when you have a pre-built app and only need to package it.
 #
-# Expects: out/Default_<arch>/browseros
-# Invoke with:
-#   browseros build --config build/config/package.linux.yaml --arch x64
-#   browseros build --config build/config/package.linux.yaml --arch arm64
+# Expects: out/Default/chrome (Linux binary)
 #
 # Environment Variables:
 #   Use !env tag to reference environment variables:
@@ -14,6 +11,7 @@
 
 build:
   type: release
+  architecture: x64  # Linux x64
 
 gn_flags:
   file: build/config/gn/flags.linux.release.gn

packages/browseros/build/config/release.linux.yaml

@@ -1,24 +1,17 @@
 # BrowserOS Linux Release Build Configuration
 #
-# Pinned to arm64-only to validate the cross-compile sysroot bootstrap
-# end-to-end on a Linux x64 host. Flip back to `[x64, arm64]` once arm64
-# is green.
-#
-# Run:
-#   browseros build --config build/config/release.linux.yaml
-#
 # Environment Variables:
 #   Use !env tag to reference environment variables:
 #     Example: chromium_src: !env CHROMIUM_SRC
 
 build:
   type: release
-  architecture: arm64
+  architecture: x64  # Linux x64
 
 gn_flags:
   file: build/config/gn/flags.linux.release.gn
 
-# Explicit module execution order. Runs once per architecture above.
+# Explicit module execution order
 modules:
   # Phase 1: Setup
   - clean

packages/browseros/build/modules/package/linux.py

@@ -17,64 +17,10 @@ from ...common.utils import (
     run_command,
     safe_rmtree,
     join_paths,
-    get_platform_arch,
     IS_LINUX,
 )
 from ...common.notify import get_notifier, COLOR_GREEN
 
-# Target-arch packaging metadata. These describe the artifact we're
-# producing, not the build machine. `appimage_arch` is passed to
-# appimagetool via the ARCH env var; `deb_arch` is written into the
-# .deb control file.
-LINUX_ARCHITECTURE_CONFIG = {
-    "x64": {
-        "appimage_arch": "x86_64",
-        "deb_arch": "amd64",
-    },
-    "arm64": {
-        "appimage_arch": "aarch64",
-        "deb_arch": "arm64",
-    },
-}
-
-# Host-arch tool selection. appimagetool is a normal binary that runs on
-# the build machine — when cross-compiling arm64 from an x64 host, we
-# still need the x86_64 tool to actually execute. Keyed on
-# get_platform_arch() (BUILD machine arch), NOT ctx.architecture.
-LINUX_HOST_APPIMAGETOOL = {
-    "x64": (
-        "appimagetool-x86_64.AppImage",
-        "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage",
-    ),
-    "arm64": (
-        "appimagetool-aarch64.AppImage",
-        "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-aarch64.AppImage",
-    ),
-}
-
-
-def get_linux_architecture_config(architecture: str) -> dict[str, str]:
-    config = LINUX_ARCHITECTURE_CONFIG.get(architecture)
-    if not config:
-        supported = ", ".join(sorted(LINUX_ARCHITECTURE_CONFIG))
-        raise ValueError(
-            f"Unsupported Linux architecture: {architecture}. Supported: {supported}"
-        )
-    return config
-
-
-def get_host_appimagetool() -> tuple[str, str]:
-    """Return (filename, url) for the appimagetool binary that runs on
-    the current build machine. Critical for cross-compile correctness."""
-    host_arch = get_platform_arch()
-    tool = LINUX_HOST_APPIMAGETOOL.get(host_arch)
-    if not tool:
-        supported = ", ".join(sorted(LINUX_HOST_APPIMAGETOOL))
-        raise ValueError(
-            f"No appimagetool binary for host arch '{host_arch}'. Supported: {supported}"
-        )
-    return tool
-
 
 class LinuxPackageModule(CommandModule):
     produces = ["appimage", "deb"]
@@ -84,10 +30,6 @@ class LinuxPackageModule(CommandModule):
     def validate(self, ctx: Context) -> None:
         if not IS_LINUX():
             raise ValidationError("Linux packaging requires Linux")
-        try:
-            get_linux_architecture_config(ctx.architecture)
-        except ValueError as exc:
-            raise ValidationError(str(exc)) from exc
 
         out_dir = join_paths(ctx.chromium_src, ctx.out_dir)
         chrome_binary = join_paths(out_dir, ctx.BROWSEROS_APP_NAME)
@@ -131,7 +73,7 @@ class LinuxPackageModule(CommandModule):
             artifacts.append(deb_path.name)
         notifier.notify(
             "📦 Package Created",
-            "Linux packages created successfully",
+            f"Linux packages created successfully",
             {
                 "Artifacts": ", ".join(artifacts),
                 "Version": ctx.semantic_version,
@@ -342,30 +284,25 @@ export CHROME_WRAPPER="${{THIS}}"
 
 
 def download_appimagetool(ctx: Context) -> Optional[Path]:
-    """Download the appimagetool binary that runs on the build machine.
-
-    Note: this is keyed on the HOST arch, not ctx.architecture. When
-    cross-compiling arm64 packages from an x64 host, we still need the
-    x86_64 appimagetool because the tool executes locally; the target
-    arch is communicated via the ARCH env var in create_appimage().
-    """
+    """Download appimagetool if not available"""
     tool_dir = Path(join_paths(ctx.root_dir, "build", "tools"))
     tool_dir.mkdir(exist_ok=True)
 
-    tool_filename, url = get_host_appimagetool()
-    tool_path = Path(join_paths(tool_dir, tool_filename))
+    tool_path = Path(join_paths(tool_dir, "appimagetool-x86_64.AppImage"))
 
     if tool_path.exists():
-        log_info(f"✓ appimagetool already available ({tool_filename})")
+        log_info("✓ appimagetool already available")
         return tool_path
 
-    log_info(f"📥 Downloading {tool_filename}...")
+    log_info("📥 Downloading appimagetool...")
+    url = "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
+
     cmd = ["wget", "-O", str(tool_path), url]
     result = run_command(cmd, check=False)
 
     if result.returncode == 0:
         tool_path.chmod(0o755)
-        log_success(f"✓ Downloaded {tool_filename}")
+        log_success("✓ Downloaded appimagetool")
         return tool_path
     else:
         log_error("Failed to download appimagetool")
@@ -375,7 +312,6 @@ def download_appimagetool(ctx: Context) -> Optional[Path]:
 def create_appimage(ctx: Context, appdir: Path, output_path: Path) -> bool:
     """Create AppImage from AppDir"""
     log_info("📦 Creating AppImage...")
-    arch_config = get_linux_architecture_config(ctx.architecture)
 
     # Download appimagetool if needed
     appimagetool = download_appimagetool(ctx)
@@ -383,7 +319,7 @@ def create_appimage(ctx: Context, appdir: Path, output_path: Path) -> bool:
         return False
 
     # Set architecture environment variable (required by appimagetool)
-    arch = arch_config["appimage_arch"]
+    arch = "x86_64" if ctx.architecture == "x64" else "aarch64"
 
     # Create AppImage with ARCH env var set for this command only
     cmd = [
@@ -448,7 +384,7 @@ def create_control_file(ctx: Context, debian_dir: Path) -> None:
     version = version.lstrip("v").replace(" ", "").replace("_", ".")
 
     # Architecture mapping
-    deb_arch = get_linux_architecture_config(ctx.architecture)["deb_arch"]
+    deb_arch = "amd64" if ctx.architecture == "x64" else "arm64"
 
     control_content = f"""Package: browseros
 Version: {version}
@@ -717,9 +653,7 @@ def package_appimage(ctx: Context, package_dir: Path) -> Optional[Path]:
     """
     log_info("🖼️  Building AppImage...")
 
-    appdir = Path(
-        join_paths(package_dir, f"{ctx.BROWSEROS_APP_BASE_NAME}-{ctx.architecture}.AppDir")
-    )
+    appdir = Path(join_paths(package_dir, f"{ctx.BROWSEROS_APP_BASE_NAME}.AppDir"))
     if appdir.exists():
         safe_rmtree(appdir)
 
@@ -749,9 +683,7 @@ def package_deb(ctx: Context, package_dir: Path) -> Optional[Path]:
     """
     log_info("📦 Building .deb package...")
 
-    debdir = Path(
-        join_paths(package_dir, f"{ctx.BROWSEROS_APP_BASE_NAME}_{ctx.architecture}_deb")
-    )
+    debdir = Path(join_paths(package_dir, f"{ctx.BROWSEROS_APP_BASE_NAME}_deb"))
     if debdir.exists():
         safe_rmtree(debdir)
 
@@ -771,8 +703,6 @@ def package_deb(ctx: Context, package_dir: Path) -> Optional[Path]:
         return output_path
 
     return None
-
-
 def package_universal(contexts: List[Context]) -> bool:
     """Linux doesn't support universal binaries"""
     log_warning("Universal binaries are not supported on Linux")

packages/browseros/build/modules/package/linux_test.py

@@ -1,63 +0,0 @@
-#!/usr/bin/env python3
-"""Tests for Linux packaging architecture helpers."""
-
-import unittest
-from unittest.mock import patch
-
-from build.modules.package.linux import (
-    LINUX_HOST_APPIMAGETOOL,
-    get_host_appimagetool,
-    get_linux_architecture_config,
-)
-
-
-class LinuxArchitectureConfigTest(unittest.TestCase):
-    def test_returns_x64_packaging_config(self) -> None:
-        config = get_linux_architecture_config("x64")
-
-        self.assertEqual(config["appimage_arch"], "x86_64")
-        self.assertEqual(config["deb_arch"], "amd64")
-
-    def test_returns_arm64_packaging_config(self) -> None:
-        config = get_linux_architecture_config("arm64")
-
-        self.assertEqual(config["appimage_arch"], "aarch64")
-        self.assertEqual(config["deb_arch"], "arm64")
-
-    def test_rejects_unsupported_architecture(self) -> None:
-        with self.assertRaisesRegex(ValueError, "Unsupported Linux architecture"):
-            get_linux_architecture_config("universal")
-
-
-class HostAppImageToolTest(unittest.TestCase):
-    """The appimagetool binary must match the BUILD machine's arch, not
-    the target arch — otherwise cross-compiling arm64 packages from an x64
-    host fails because the aarch64 tool can't execute on x64."""
-
-    def test_x64_host_picks_x86_64_tool(self) -> None:
-        with patch(
-            "build.modules.package.linux.get_platform_arch", return_value="x64"
-        ):
-            filename, url = get_host_appimagetool()
-
-        self.assertEqual(filename, "appimagetool-x86_64.AppImage")
-        self.assertIn("x86_64", url)
-
-    def test_arm64_host_picks_aarch64_tool(self) -> None:
-        with patch(
-            "build.modules.package.linux.get_platform_arch", return_value="arm64"
-        ):
-            filename, url = get_host_appimagetool()
-
-        self.assertEqual(filename, "appimagetool-aarch64.AppImage")
-        self.assertIn("aarch64", url)
-
-    def test_host_lookup_independent_of_target(self) -> None:
-        # Both architectures must be present in the host lookup so cross
-        # builds work in either direction.
-        self.assertIn("x64", LINUX_HOST_APPIMAGETOOL)
-        self.assertIn("arm64", LINUX_HOST_APPIMAGETOOL)
-
-
-if __name__ == "__main__":
-    unittest.main()

packages/browseros/build/modules/release/common.py

@@ -6,6 +6,7 @@ from datetime import datetime
 from typing import Dict, List, Optional
 
 from ...common.env import EnvConfig
+from ...common.utils import log_warning
 from ..storage import get_release_json, get_r2_client, BOTO3_AVAILABLE
 
 PLATFORMS = ["macos", "win", "linux"]
@@ -23,8 +24,6 @@ DOWNLOAD_PATH_MAPPING = {
     "linux": {
         "x64_appimage": "download/BrowserOS.AppImage",
         "x64_deb": "download/BrowserOS.deb",
-        "arm64_appimage": "download/BrowserOS-arm64.AppImage",
-        "arm64_deb": "download/BrowserOS-arm64.deb",
     },
 }
 

packages/browseros/build/modules/setup/configure.py

@@ -1,19 +1,9 @@
 #!/usr/bin/env python3
 """Build configuration module for BrowserOS build system"""
 
-import sys
-
 from ...common.module import CommandModule, ValidationError
 from ...common.context import Context
-from ...common.utils import (
-    run_command,
-    log_info,
-    log_warning,
-    log_success,
-    join_paths,
-    IS_LINUX,
-    IS_WINDOWS,
-)
+from ...common.utils import run_command, log_info, log_success, join_paths, IS_WINDOWS
 
 
 class ConfigureModule(CommandModule):
@@ -35,16 +25,6 @@ class ConfigureModule(CommandModule):
     def execute(self, ctx: Context) -> None:
         log_info(f"\n⚙️  Configuring {ctx.build_type} build for {ctx.architecture}...")
 
-        # Linux: ensure the target-arch Debian sysroot is installed before
-        # `gn gen`. sysroot.gni asserts on missing sysroots, and relying on
-        # `gclient sync` DEPS hooks is fragile — the hook only fires when
-        # .gclient declared the right `target_cpus` *before* sync, which
-        # isn't guaranteed for chromium_src checkouts that predate
-        # cross-arch support. install-sysroot.py is idempotent and fast,
-        # so call it unconditionally for the target arch.
-        if IS_LINUX():
-            self._ensure_linux_sysroot(ctx)
-
         out_path = join_paths(ctx.chromium_src, ctx.out_dir)
         out_path.mkdir(parents=True, exist_ok=True)
 
@@ -63,26 +43,3 @@ class ConfigureModule(CommandModule):
         run_command(gn_args, cwd=ctx.chromium_src)
 
         log_success("Build configured")
-
-    def _ensure_linux_sysroot(self, ctx: Context) -> None:
-        install_script = (
-            ctx.chromium_src / "build" / "linux" / "sysroot_scripts" / "install-sysroot.py"
-        )
-        if not install_script.exists():
-            log_warning(
-                f"⚠️  install-sysroot.py not found at {install_script}; "
-                f"skipping sysroot bootstrap. gn gen will fail if the "
-                f"{ctx.architecture} sysroot is missing."
-            )
-            return
-
-        # install-sysroot.py accepts our arch names directly: it translates
-        # `x64`→`amd64` internally via ARCH_TRANSLATIONS, and `arm64` is a
-        # valid pass-through value.
-        log_info(
-            f"📦 Ensuring Linux sysroot for {ctx.architecture} (idempotent)..."
-        )
-        run_command(
-            [sys.executable, str(install_script), f"--arch={ctx.architecture}"],
-            cwd=ctx.chromium_src,
-        )

packages/browseros/build/modules/setup/git.py

@@ -1,24 +1,12 @@
 #!/usr/bin/env python3
 """Git operations module for BrowserOS build system"""
 
-import re
 import subprocess
 import tarfile
 import urllib.request
-from typing import List
-
 from ...common.module import CommandModule, ValidationError
 from ...common.context import Context
-from ...common.utils import (
-    run_command,
-    log_info,
-    log_warning,
-    log_error,
-    log_success,
-    IS_LINUX,
-    IS_WINDOWS,
-    safe_rmtree,
-)
+from ...common.utils import run_command, log_info, log_error, log_success, IS_WINDOWS, safe_rmtree
 
 
 class GitSetupModule(CommandModule):
@@ -44,12 +32,6 @@ class GitSetupModule(CommandModule):
         log_info(f"🔀 Checking out tag: {ctx.chromium_version}")
         run_command(["git", "checkout", f"tags/{ctx.chromium_version}"], cwd=ctx.chromium_src)
 
-        # On Linux, depot_tools fetches per-arch sysroots automatically when
-        # `.gclient` declares `target_cpus`. Ensure both x64 and arm64 are
-        # listed before sync so cross-compilation just works on x64 hosts.
-        if IS_LINUX():
-            self._ensure_gclient_target_cpus(ctx, ["x64", "arm64"])
-
         log_info("📥 Syncing dependencies (this may take a while)...")
         if IS_WINDOWS():
             run_command(["gclient.bat", "sync", "-D", "--no-history", "--shallow"], cwd=ctx.chromium_src)
@@ -58,49 +40,6 @@ class GitSetupModule(CommandModule):
 
         log_success("Git setup complete")
 
-    def _ensure_gclient_target_cpus(self, ctx: Context, required: List[str]) -> None:
-        """Idempotently add `target_cpus` to .gclient so depot_tools fetches
-        the matching Linux sysroots for cross-compilation.
-
-        depot_tools convention: .gclient lives one directory above
-        chromium_src (i.e. ../.gclient). It is a Python file with a list
-        of solution dicts followed by optional top-level assignments.
-        We append a `target_cpus = [...]` line if missing or merge in any
-        archs that aren't already present.
-        """
-        gclient_path = ctx.chromium_src.parent / ".gclient"
-        if not gclient_path.exists():
-            log_warning(
-                f"⚠️  .gclient not found at {gclient_path}; "
-                f"skipping target_cpus bootstrap. "
-                f"Cross-arch builds may fail until you run `fetch chromium`."
-            )
-            return
-
-        content = gclient_path.read_text()
-        match = re.search(r"^\s*target_cpus\s*=\s*\[([^\]]*)\]", content, re.MULTILINE)
-
-        if match:
-            existing = re.findall(r"['\"]([^'\"]+)['\"]", match.group(1))
-            missing = [arch for arch in required if arch not in existing]
-            if not missing:
-                log_info(f"✓ .gclient target_cpus already includes {required}")
-                return
-            merged = sorted(set(existing) | set(required))
-            new_line = f"target_cpus = {merged!r}"
-            content = (
-                content[: match.start()] + new_line + content[match.end() :]
-            )
-            log_info(
-                f"📝 Updating .gclient target_cpus: {existing} → {merged}"
-            )
-        else:
-            new_line = f"\ntarget_cpus = {required!r}\n"
-            content = content.rstrip() + "\n" + new_line
-            log_info(f"📝 Adding target_cpus = {required} to .gclient")
-
-        gclient_path.write_text(content)
-
     def _verify_tag_exists(self, ctx: Context) -> None:
         result = subprocess.run(
             ["git", "tag", "-l", ctx.chromium_version],

packages/browseros/build/modules/storage/upload.py

@@ -4,7 +4,7 @@
 import json
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple, cast
+from typing import Dict, List, Optional, Tuple
 
 from ...common.module import CommandModule, ValidationError
 from ...common.context import Context
@@ -21,7 +21,6 @@ from ...common.notify import get_notifier, COLOR_GREEN
 from .r2 import (
     BOTO3_AVAILABLE,
     get_r2_client,
-    get_release_json,
     upload_file_to_r2,
 )
 
@@ -59,10 +58,7 @@ class UploadModule(CommandModule):
         log_info("\nUploading package artifacts to R2...")
 
         extra_metadata = {}
-        sparkle_signatures = cast(
-            Optional[dict[str, tuple[str, int]]],
-            ctx.artifacts.get("sparkle_signatures"),
-        )
+        sparkle_signatures = ctx.artifacts.get("sparkle_signatures")
         if sparkle_signatures:
             for filename, (sig, length) in sparkle_signatures.items():
                 extra_metadata[filename] = {
@@ -124,36 +120,6 @@ def generate_release_json(
     return release_data
 
 
-def merge_release_metadata(existing: Optional[Dict], new: Dict) -> Dict:
-    if not existing:
-        return new
-
-    merged = dict(existing)
-    merged.update({key: value for key, value in new.items() if key != "artifacts"})
-
-    artifacts = dict(existing.get("artifacts", {}))
-    artifacts.update(new.get("artifacts", {}))
-    merged["artifacts"] = artifacts
-    return merged
-
-
-def _get_linux_artifact_key(filename: str) -> Optional[str]:
-    lower = filename.lower()
-
-    if ".appimage" in lower:
-        if "arm64" in lower or "aarch64" in lower:
-            return "arm64_appimage"
-        if "x64" in lower or "x86_64" in lower:
-            return "x64_appimage"
-    elif ".deb" in lower:
-        if "arm64" in lower or "aarch64" in lower:
-            return "arm64_deb"
-        if "amd64" in lower or "x64" in lower or "x86_64" in lower:
-            return "x64_deb"
-
-    return None
-
-
 def _get_artifact_key(filename: str, platform: str) -> str:
     """Get artifact key name from filename
 
@@ -181,10 +147,10 @@ def _get_artifact_key(filename: str, platform: str) -> str:
             return "x64_zip"
 
     elif platform == "linux":
-        artifact_key = _get_linux_artifact_key(filename)
-        if artifact_key:
-            return artifact_key
-        log_warning(f"Unrecognized Linux artifact name: {filename}; using stem key")
+        if ".appimage" in lower:
+            return "x64_appimage"
+        elif ".deb" in lower:
+            return "x64_deb"
 
     return Path(filename).stem
 
@@ -215,7 +181,7 @@ def detect_artifacts(ctx: Context) -> List[Path]:
 
 def upload_release_artifacts(
     ctx: Context,
-    extra_metadata: Optional[Dict[str, Dict[str, Any]]] = None,
+    extra_metadata: Optional[Dict[str, Dict[str, any]]] = None,
 ) -> Tuple[bool, Optional[Dict]]:
     """Upload release artifacts to R2 and generate release.json
 
@@ -274,13 +240,6 @@ def upload_release_artifacts(
         artifact_metadata.append(metadata)
 
     release_data = generate_release_json(ctx, artifact_metadata, platform)
-    if platform == "linux":
-        # Linux x64 and arm64 release jobs must be sequenced. A parallel
-        # fetch-merge-upload flow can still race and drop one architecture.
-        existing_release_data = get_release_json(
-            ctx.get_semantic_version(), platform, env
-        )
-        release_data = merge_release_metadata(existing_release_data, release_data)
     release_json_path = ctx.get_dist_dir() / "release.json"
     release_json_path.write_text(json.dumps(release_data, indent=2))
 
@@ -289,7 +248,7 @@ def upload_release_artifacts(
         return False, None
 
     log_success(f"\nSuccessfully uploaded {len(artifacts)} artifact(s) to R2")
-    log_info("\nRelease metadata:")
+    log_info(f"\nRelease metadata:")
     log_info(f"  Version: {release_data['version']}")
     if platform == "macos":
         log_info(f"  Sparkle version: {release_data.get('sparkle_version', 'N/A')}")

packages/browseros/build/modules/storage/upload_test.py

@@ -1,85 +0,0 @@
-#!/usr/bin/env python3
-"""Tests for release artifact upload metadata helpers."""
-
-import unittest
-
-from build.modules.storage.upload import _get_artifact_key, merge_release_metadata
-
-
-class UploadMetadataTest(unittest.TestCase):
-    def test_linux_x64_artifacts_use_x64_keys(self) -> None:
-        self.assertEqual(
-            _get_artifact_key("BrowserOS_v1.2.3_x64.AppImage", "linux"),
-            "x64_appimage",
-        )
-        self.assertEqual(
-            _get_artifact_key("BrowserOS_v1.2.3_amd64.deb", "linux"),
-            "x64_deb",
-        )
-
-    def test_linux_arm64_artifacts_use_arm64_keys(self) -> None:
-        self.assertEqual(
-            _get_artifact_key("BrowserOS_v1.2.3_arm64.AppImage", "linux"),
-            "arm64_appimage",
-        )
-        self.assertEqual(
-            _get_artifact_key("BrowserOS_v1.2.3_arm64.deb", "linux"),
-            "arm64_deb",
-        )
-        self.assertEqual(
-            _get_artifact_key("BrowserOS_v1.2.3_aarch64.deb", "linux"),
-            "arm64_deb",
-        )
-
-    def test_merge_release_metadata_preserves_existing_artifacts(self) -> None:
-        existing = {
-            "platform": "linux",
-            "version": "1.2.3",
-            "build_date": "old",
-            "artifacts": {
-                "x64_appimage": {"filename": "BrowserOS_v1.2.3_x64.AppImage"},
-                "x64_deb": {"filename": "BrowserOS_v1.2.3_amd64.deb"},
-            },
-        }
-        new = {
-            "platform": "linux",
-            "version": "1.2.3",
-            "build_date": "new",
-            "artifacts": {
-                "arm64_appimage": {"filename": "BrowserOS_v1.2.3_arm64.AppImage"},
-                "arm64_deb": {"filename": "BrowserOS_v1.2.3_arm64.deb"},
-            },
-        }
-
-        merged = merge_release_metadata(existing, new)
-
-        self.assertEqual(merged["build_date"], "new")
-        self.assertEqual(
-            sorted(merged["artifacts"]),
-            ["arm64_appimage", "arm64_deb", "x64_appimage", "x64_deb"],
-        )
-
-    def test_merge_release_metadata_overwrites_matching_artifact_keys(self) -> None:
-        existing = {
-            "platform": "linux",
-            "version": "1.2.3",
-            "artifacts": {
-                "x64_appimage": {"filename": "old.AppImage", "size": 1},
-            },
-        }
-        new = {
-            "platform": "linux",
-            "version": "1.2.3",
-            "artifacts": {
-                "x64_appimage": {"filename": "new.AppImage", "size": 2},
-            },
-        }
-
-        merged = merge_release_metadata(existing, new)
-
-        self.assertEqual(merged["artifacts"]["x64_appimage"]["filename"], "new.AppImage")
-        self.assertEqual(merged["artifacts"]["x64_appimage"]["size"], 2)
-
-
-if __name__ == "__main__":
-    unittest.main()

packages/browseros/chromium_patches/chrome/browser/browseros/extensions/browseros_extension_loader.cc

@@ -1,9 +1,9 @@
 diff --git a/chrome/browser/browseros/extensions/browseros_extension_loader.cc b/chrome/browser/browseros/extensions/browseros_extension_loader.cc
 new file mode 100644
-index 0000000000000..fdb6be443f25b
+index 0000000000000..e61b45d08b7e2
 --- /dev/null
 +++ b/chrome/browser/browseros/extensions/browseros_extension_loader.cc
-@@ -0,0 +1,269 @@
+@@ -0,0 +1,226 @@
 +// Copyright 2024 The Chromium Authors
 +// Use of this source code is governed by a BSD-style license that can be
 +// found in the LICENSE file.
@@ -89,53 +89,10 @@ index 0000000000000..fdb6be443f25b
 +  extension_ids_.merge(result.extension_ids);
 +  last_config_ = std::move(result.config);
 +
-+  base::DictValue prefs_to_load = std::move(result.prefs);
-+
-+  if (prefs_to_load.empty()) {
-+    LOG(WARNING) << "browseros: Install returned empty prefs, "
-+                 << "reconstructing from installed extensions";
-+    prefs_to_load = ReconstructPrefsFromInstalledExtensions();
-+    LOG(INFO) << "browseros: Reconstructed prefs for "
-+              << prefs_to_load.size() << " installed extensions";
-+  }
-+
-+  LoadFinished(std::move(prefs_to_load));
++  LoadFinished(std::move(result.prefs));
 +  OnStartupComplete(result.from_bundled);
 +}
 +
-+base::DictValue
-+BrowserOSExtensionLoader::ReconstructPrefsFromInstalledExtensions() {
-+  base::DictValue prefs;
-+
-+  extensions::ExtensionRegistry* registry =
-+      extensions::ExtensionRegistry::Get(profile_);
-+  if (!registry) {
-+    return prefs;
-+  }
-+
-+  const std::string update_url =
-+      base::FeatureList::IsEnabled(features::kBrowserOsAlphaFeatures)
-+          ? kBrowserOSAlphaUpdateUrl
-+          : kBrowserOSUpdateUrl;
-+
-+  for (const std::string& id : GetBrowserOSExtensionIds()) {
-+    const extensions::Extension* ext = registry->GetInstalledExtension(id);
-+    if (!ext) {
-+      continue;
-+    }
-+
-+    base::DictValue ext_pref;
-+    ext_pref.Set(extensions::ExternalProviderImpl::kExternalUpdateUrl,
-+                 update_url);
-+    prefs.Set(id, std::move(ext_pref));
-+
-+    LOG(INFO) << "browseros: Reconstructed pref for installed extension "
-+              << id << " v" << ext->version().GetString();
-+  }
-+
-+  return prefs;
-+}
-+
 +const base::FilePath BrowserOSExtensionLoader::GetBaseCrxFilePath() {
 +  return bundled_crx_base_path_;
 +}

packages/browseros/chromium_patches/chrome/browser/browseros/extensions/browseros_extension_loader.h

@@ -1,9 +1,9 @@
 diff --git a/chrome/browser/browseros/extensions/browseros_extension_loader.h b/chrome/browser/browseros/extensions/browseros_extension_loader.h
 new file mode 100644
-index 0000000000000..ea2c856556f5f
+index 0000000000000..2a14e9068156e
 --- /dev/null
 +++ b/chrome/browser/browseros/extensions/browseros_extension_loader.h
-@@ -0,0 +1,86 @@
+@@ -0,0 +1,81 @@
 +// Copyright 2024 The Chromium Authors
 +// Use of this source code is governed by a BSD-style license that can be
 +// found in the LICENSE file.
@@ -62,11 +62,6 @@ index 0000000000000..ea2c856556f5f
 +  // Convergence point for both startup paths.
 +  void OnStartupComplete(bool from_bundled);
 +
-+  // Reconstructs minimal prefs from already-installed BrowserOS extensions.
-+  // Used as a fallback when both bundled CRX and remote config fail,
-+  // preventing orphan detection from uninstalling existing extensions.
-+  base::DictValue ReconstructPrefsFromInstalledExtensions();
-+
 +  // Installs remote extensions immediately via PendingExtensionManager + updater.
 +  void InstallRemoteExtensionsNow(base::DictValue config);
 +

packages/browseros/chromium_patches/chrome/browser/browseros/extensions/browseros_extension_maintainer.cc

@@ -1,6 +1,6 @@
 diff --git a/chrome/browser/browseros/extensions/browseros_extension_maintainer.cc b/chrome/browser/browseros/extensions/browseros_extension_maintainer.cc
 new file mode 100644
-index 0000000000000..5804d54696e8f
+index 0000000000000..bb33ae5d3b156
 --- /dev/null
 +++ b/chrome/browser/browseros/extensions/browseros_extension_maintainer.cc
 @@ -0,0 +1,395 @@

packages/browseros/chromium_patches/chrome/browser/extensions/chrome_extension_registrar_delegate.cc

@@ -1,5 +1,5 @@
 diff --git a/chrome/browser/extensions/chrome_extension_registrar_delegate.cc b/chrome/browser/extensions/chrome_extension_registrar_delegate.cc
-index adfb4e4d49fa4..409e26fa1cb1b 100644
+index 6eec0585e8925..55c2a73647527 100644
 --- a/chrome/browser/extensions/chrome_extension_registrar_delegate.cc
 +++ b/chrome/browser/extensions/chrome_extension_registrar_delegate.cc
 @@ -12,6 +12,7 @@
@@ -10,26 +10,7 @@ index adfb4e4d49fa4..409e26fa1cb1b 100644
  #include "chrome/browser/extensions/component_loader.h"
  #include "chrome/browser/extensions/corrupted_extension_reinstaller.h"
  #include "chrome/browser/extensions/data_deleter.h"
-@@ -256,7 +257,17 @@ void ChromeExtensionRegistrarDelegate::PostUninstallExtension(
-     }
-   }
- 
--  DataDeleter::StartDeleting(profile_, extension.get(), subtask_done_callback);
-+  // Preserve chrome.storage.local data for BrowserOS extensions. These may be
-+  // transiently uninstalled during update cycles (e.g., when both bundled CRX
-+  // and remote config fail on startup). User configuration must survive.
-+  if (browseros::IsBrowserOSExtension(extension->id())) {
-+    LOG(INFO) << "browseros: Preserving storage for extension "
-+              << extension->id();
-+    subtask_done_callback.Run();
-+  } else {
-+    DataDeleter::StartDeleting(profile_, extension.get(),
-+                               subtask_done_callback);
-+  }
- }
- 
- void ChromeExtensionRegistrarDelegate::DoLoadExtensionForReload(
-@@ -322,6 +333,13 @@ bool ChromeExtensionRegistrarDelegate::CanDisableExtension(
+@@ -317,6 +318,13 @@ bool ChromeExtensionRegistrarDelegate::CanDisableExtension(
      return true;
    }