fix: address greptile review comments for klavis strata cache

- Drop dead `invalidated` field on InflightEntry. It was added to
  support a "discard post-resolution if invalidated" check that I
  later replaced with identity-checked deletes during self-review,
  but I forgot to remove the field and the misleading comment
  referencing it. Simplify Map<string, InflightEntry> to plain
  Map<string, Promise<CacheEntry>>.
- Lower cache miss log from info to debug. Misses fire on every new
  conversation; matching the existing debug-level for hits.
- Stop routing the /klavis/servers/remove handler through
  klavisStrataCache.getOrFetch. The chat hot path keys its cache by
  the user's full enabled-server set (e.g. hash('Gmail,Linear')),
  so a single-server lookup here (hash('Gmail')) is guaranteed to
  miss, write a spurious entry, and then have it immediately
  cleared by invalidate() on the next line. Call createStrata
  directly to recover the strataId, mirroring the original
  removeServer flow.

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/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.81",
   "description": "BrowserOS server",
   "type": "module",
   "main": "./src/index.ts",

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/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'
@@ -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/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/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/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.81",
       "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/build/config/release.linux.yaml

@@ -1,8 +1,8 @@
 # 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.
+# Builds both x64 and arm64 in a single invocation on a Linux x64 host.
+# The runner loops the entire pipeline once per architecture; depot_tools
+# fetches the matching sysroots automatically (see git_setup module).
 #
 # Run:
 #   browseros build --config build/config/release.linux.yaml
@@ -13,7 +13,7 @@
 
 build:
   type: release
-  architecture: arm64
+  architecture: [x64, arm64]  # Builds both arches sequentially in one run
 
 gn_flags:
   file: build/config/gn/flags.linux.release.gn

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,
-        )