@stack-spot/ai-chat-widget 2.8.5 → 2.10.0

package/dist/views/Steps/utils.js

@@ -12,8 +12,8 @@ export function getStatusIcon(status) {
 }
 export function getTypeIcon(type) {
     switch (type) {
-        case 'planning': return { group: 'outline', icon: 'ListUnordered' };
-        default: return { group: 'fill', icon: 'Play' };
+        case 'planning': return { group: 'fill', icon: 'ChevronRight' };
+        default: return { group: 'outline', icon: 'StackSpot' };
     }
 }
 export function getTitle(translation, step, index) {

package/dist/views/Steps/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/views/Steps/utils.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAY,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAEhD,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,aAAa,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAI,CAAA;QAC3G,KAAK,OAAO,CAAC,CAAC,OAAO,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,aAAa,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAI,CAAA;QACxG,KAAK,SAAS,CAAC,CAAC,OAAO,KAAC,gBAAgB,IAAC,WAAW,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,GAAG,CAAA;QAC3E,OAAO,CAAC,CAAC,OAAO,IAAI,CAAA;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,CAAA;QACnE,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,WAA2D,EAAE,IAA0B,EAAE,KAAa;IAC7H,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU,CAAC,CAAC,OAAO,WAAW,CAAC,QAAQ,CAAA;QAC5C,KAAK,MAAM,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,IAAI,KAAK,EAAE,CAAA;QAClD,KAAK,QAAQ,CAAC,CAAC,OAAO,WAAW,CAAC,MAAM,CAAA;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,eAAe,GAAG,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAA;AACxC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/views/Steps/utils.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAY,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAEhD,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,aAAa,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAI,CAAA;QAC3G,KAAK,OAAO,CAAC,CAAC,OAAO,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,aAAa,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAI,CAAA;QACxG,KAAK,SAAS,CAAC,CAAC,OAAO,KAAC,gBAAgB,IAAC,WAAW,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,GAAG,CAAA;QAC3E,OAAO,CAAC,CAAC,OAAO,IAAI,CAAA;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAA;QAC/D,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,WAA2D,EAAE,IAA0B,EAAE,KAAa;IAC7H,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU,CAAC,CAAC,OAAO,WAAW,CAAC,QAAQ,CAAA;QAC5C,KAAK,MAAM,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,IAAI,KAAK,EAAE,CAAA;QAClD,KAAK,QAAQ,CAAC,CAAC,OAAO,WAAW,CAAC,MAAM,CAAA;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,eAAe,GAAG,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAA;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stack-spot/ai-chat-widget",
-  "version": "2.8.5",
+  "version": "2.10.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,7 @@
     "@citric/core": "^6.4.0",
     "@stack-spot/portal-components": "^2.27.3",
     "@citric/icons": "^5.13.0",
-    "@stack-spot/portal-network": "0.211.2",
+    "@stack-spot/portal-network": "0.212.0",
     "@citric/ui": "^6.10.2",
     "@stack-spot/portal-translate": "^2.1.0",
     "lodash": "^4.17.0",

package/src/app-metadata.json

@@ -1,7 +1,7 @@
 {
   "name": "@stack-spot/ai-chat-widget",
-  "version": "2.8.5",
-  "date": "Mon Dec 22 2025 20:53:44 GMT+0000 (Coordinated Universal Time)",
+  "version": "2.10.0",
+  "date": "Tue Jan 06 2026 12:17:53 GMT+0000 (Coordinated Universal Time)",
   "dependencies": [
     {
       "name": "@stack-spot/app-metadata",
@@ -121,7 +121,7 @@
     },
     {
       "name": "@stack-spot/portal-network",
-      "version": "0.211.2(@stack-spot/auth@6.1.0)(@stack-spot/opa@2.5.0(@stack-spot/auth@6.1.0)(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@stack-spot/portal-translate@2.1.0(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@tanstack/react-query@5.59.16(react@18.2.0))(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
+      "version": "0.212.0(@stack-spot/auth@6.1.0)(@stack-spot/opa@2.5.0(@stack-spot/auth@6.1.0)(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@stack-spot/portal-translate@2.1.0(react-dom@18.2.0(react@18.2.0))(react@18.2.0))(@tanstack/react-query@5.59.16(react@18.2.0))(react-dom@18.2.0(react@18.2.0))(react@18.2.0)"
     },
     {
       "name": "@stack-spot/portal-theme",

package/src/chat-interceptors/quick-commands.ts

@@ -370,7 +370,14 @@ export function createQuickCommandInterceptor(widget: WidgetState, getEditor: ()
     }
     
     if (ctx.qc.use_selected_code && (!code && ctx.context.upload_ids?.length === 0)) {
-      throw new Error(t.requiresSelection)
+      widget.set('panel', 'editor')
+      ctx.chat.pushMessage(new ChatEntry({
+        agentType: 'bot',
+        type: 'text',
+        agent: ctx.chat.get('agent'),
+        content: t.requiresSelection,
+      }))
+      return 
     }
     manageConversationContext(ctx)
     await computeCustomInputs(ctx)
@@ -458,8 +465,10 @@ export function createQuickCommandInterceptor(widget: WidgetState, getEditor: ()
     const start = new Date().getTime()
     try {
       const result = await runQuickCommand(ctx)
-      outputResult(ctx, result)
-      registerAnalyticsEvent(ctx, '200', start)
+      if (result) {
+        outputResult(ctx, result)
+        registerAnalyticsEvent(ctx, '200', start)
+      }
     } catch (error: any) {
       let message = error.message || `${error}`
       if (error instanceof AbortedError || error instanceof CancelledError) message = t.aborted
@@ -483,14 +492,14 @@ export function createQuickCommandInterceptor(widget: WidgetState, getEditor: ()
 
 const dictionary = {
   en: {
-    requiresSelection: 'This quick command requires some code to be selected in the editor. To open the editor click the icon "{/}" in the field below.',
+    requiresSelection: 'Select the code in the editor next to it for this quick command to interact with it.',
     startQuestioning: 'To execute the Quick Command "$0", I\'ll need you to provide some information. Some may be mandatory, and others optional. Let\'s get started.',
     progress: 'Running step "$0" from Quick Command "$1".',
     aborted: 'The quick command execution aborted by the user.',
     notFound: 'There\'s no quick command with the provided name. If you don\'t wish to run a command, prefix the first "/" with a "\\".',
   },
   pt: {
-    requiresSelection: 'Este quick command precisa que algum código esteja selecionado no editor. Para abrir o editor clique no ícone "{/}" no campo abaixo.',
+    requiresSelection: 'Selecione o código no editor ao lado para que este quick command possa interagir com ele.',
     startQuestioning: 'Para executar o Quick Command "$0", vou precisar que você providencie algumas explicações. Algumas são obrigatórias e outras opcionais. Vamos começar.',
     progress: 'Executando step "$0" do Quick Command "$1".',
     aborted: 'A execução do quick command foi abortada pelo usuário.',

package/src/views/Chat/ButtonExecutionDetail.tsx

@@ -0,0 +1,46 @@
+import { LoadingCircular } from '@citric/ui'
+import { Button, Icon, Row } from '@stack-spot/citric-react'
+import { Dictionary, useTranslate } from '@stack-spot/portal-translate'
+import { useEffect, useMemo } from 'react'
+import { useChatMessages, useWidget } from '../../context/hooks'
+
+export const ButtonExecutionDetail = ({ chatId, messageId }: { chatId: string, messageId: number }) => {
+  const t = useTranslate(dictionary)
+  const messages = useChatMessages(chatId)
+  const widget = useWidget()
+
+  const isRunning = useMemo(() => {
+    const messageEntry = messages?.find((message) => message.id === messageId)
+    return !messageEntry?.getValue().steps?.find((step) => step.type === 'answer' && step.status !== 'running')
+  }, [messageId, messages])
+
+  function openToolsPanel() {
+    if (messageId) {
+      widget.set('currentMessageInPanel', { chatId, messageId })
+      widget.set('panel', 'steps')
+    }
+  }
+
+  useEffect(() => {
+    isRunning && openToolsPanel()
+  }, [isRunning])
+
+  return <>
+    <Row className="step-actions">
+      {isRunning && <LoadingCircular colorScheme="inverse" size="xs" />}
+      <Button colorScheme="light" size="sm" appearance="none" className="icon-button details" onClick={openToolsPanel}>
+        <Icon group="outline" icon="Expand" size="xs" />
+        {t.detailed}
+      </Button>
+    </Row>
+  </>
+}
+
+const dictionary = {
+  en: {
+    detailed: 'View execution details',
+  },
+  pt: {
+    detailed: 'Ver detalhes da execução',
+  },
+} satisfies Dictionary

package/src/views/Chat/ChatMessage.tsx

@@ -15,6 +15,7 @@ import { ChatEntry, SerializableAction, TextChatEntry } from '../../state/ChatEn
 import { useDateFormatter } from '../../utils/date'
 import { toolById } from '../../utils/tools'
 import { AgentInfo } from './AgentInfo'
+import { ButtonExecutionDetail } from './ButtonExecutionDetail'
 import { useChatScrollToBottomEffect } from './chat-scroll'
 import { onCopyAll, onCopyCode, onLikeOrDislike } from './events'
 import { StepsList, StepsPlaceholder, ViewToolsDetails } from './StepsList'
@@ -226,10 +227,10 @@ export const ChatMessage = ({ message, isLast, beforeMessage, afterMessage, cust
   const [showUserButtonCopy, setShowUserButtonCopy] = useState(false)
   const isPlanning = useCurrentChatState('isPlaning') ?? false
 
-  // Dynamic tool steps are identified by the "dynamic" id.
-  // We're temporarily hiding the toolbox for these dynamic tools while we finalize their UI.
-  const shouldHideToolbox =  entry?.steps?.some((step) => step?.id === 'dynamic')
-  const showToolBox = (!!agentsTools?.length || !!entry.tools?.length) && !shouldHideToolbox
+  // Dynamic steps are identified by the "dynamic" id.
+  const isDynamicSteps = !!entry?.steps?.some((s) => s.id?.toLowerCase() === 'dynamic')
+  const hasTools = ((agentsTools?.length ?? 0) > 0) || ((entry.tools?.length ?? 0) > 0)
+  const showToolBox = hasTools && !isDynamicSteps
   
   useChatScrollToBottomEffect(ref, [entry])
   useMidnightUpdateView()
@@ -355,7 +356,8 @@ export const ChatMessage = ({ message, isLast, beforeMessage, afterMessage, cust
     widget.set('panel', 'resources')
   }
 
-  const shouldShowToolsOnlyMessage = (entry.done !== false || entry.hasPlanning) && !!entry.steps?.length
+  const buttonExecutionDetail = useMemo(() =>  <ButtonExecutionDetail chatId={chat.id} messageId={message.id} />, [chat.id, message.id])
+  const shouldShowToolsOnlyMessage = (entry.done !== false || entry.hasPlanning || isDynamicSteps) && !!entry.steps?.length
   const shouldRender = entry.content || entry.error || shouldShowToolsOnlyMessage || !!entry.upload?.length
 
   return shouldRender && (
@@ -372,7 +374,7 @@ export const ChatMessage = ({ message, isLast, beforeMessage, afterMessage, cust
                 {entry.badges.map((b, index) => <Badge key={index} colorPalette={b.color ?? 'cyan'} appearance="square">{b.label}</Badge>)}
               </div>}
 
-              {!!entry.steps?.length && <StepsList steps={entry.steps} chatId={chat.id} messageId={message.id} />}
+              {!!entry.steps?.length && !isDynamicSteps && <StepsList steps={entry.steps} chatId={chat.id} messageId={message.id} />}
 
               {renderContent()}
 
@@ -428,6 +430,8 @@ export const ChatMessage = ({ message, isLast, beforeMessage, afterMessage, cust
           </div>
         }
 
+        {!!entry.steps?.length && isDynamicSteps && buttonExecutionDetail}
+
         {shouldShowFooter && <div className="message-footer">
           {entry.agentType === 'bot' && !entry.error && <div className="message-actions">
             {entry.type === 'md' && (

package/src/views/Steps/FlowChart/HandleGroup.tsx

@@ -3,10 +3,12 @@ import { Handle, Position } from '@xyflow/react'
 interface Props {
   renderSource?: boolean,
   renderTarget?: boolean,
+  targetPosition?: Position,
+  sourcePosition?: Position,
 }
-export const HandleGroup = ({ renderSource = true, renderTarget = true }: Props) => (
+export const HandleGroup = ({ renderSource = true, renderTarget = true, targetPosition, sourcePosition }: Props) => (
   <>
-    {renderTarget && <Handle type="target" position={Position.Left} isConnectable className="target-handle" />}
-    {renderSource && <Handle type="source" position={Position.Right} isConnectable className="source-handle" />}
+    {renderTarget && <Handle type="target" position={targetPosition || Position.Left} isConnectable className="target-handle" />}
+    {renderSource && <Handle type="source" position={sourcePosition || Position.Right} isConnectable className="source-handle" />}
   </>
 )

package/src/views/Steps/FlowChart/NodeDynamic.tsx

@@ -0,0 +1,97 @@
+import { Icon, WithIcon } from '@stack-spot/citric-icons'
+import { Avatar, Column, IconBox, Row, Skeleton, Text } from '@stack-spot/citric-react'
+import { AnimatedHeight } from '@stack-spot/portal-components/AnimatedHeight'
+import { ChatAgentTool } from '@stack-spot/portal-network'
+import { listToClass } from '@stack-spot/portal-theme'
+import { Position } from '@xyflow/react'
+import { useChatEntry } from '../../../context/hooks'
+import { useStepsDictionary } from '../dictionary'
+import { getTitle, getTypeIcon } from '../utils'
+import { HandleGroup } from './HandleGroup'
+import { useResizeObserver } from './hooks'
+import { NodeData } from './types'
+
+const ToolItem = ({ tool, index, onClick }: { tool: ChatAgentTool, index: number, onClick?: (index: number) => void }) => {
+  const { name, image, input, status } = tool
+
+  if (status === 'running') {
+    return <Skeleton height="48px" bgLevel={600} />
+  }
+
+  return (
+    <div className="tool" onClick={() => onClick?.(index)}>
+      <Row gap="4px" alignItems="center" mb={2}>
+        {image
+          ? <Avatar size="xxs" image={image} name={name} />
+          : <Icon icon="Cog" group="outline" />
+        }
+        <Text weight="500" className="title">{name}</Text>
+      </Row>
+      <Text nowrapEllipsis color="light.700">{input}</Text>
+    </div>
+  )
+}
+
+export const ListTools = ({ tools, onClick }: { tools: ChatAgentTool[], onClick?: (toolIndex?: number) => void }) => (
+  <AnimatedHeight>
+    <Column gap="8px">
+      {tools.map((tool, index) => (
+        <Column key={`${tool.id}-${index}`} className="wrapper-tool">
+          <ToolItem tool={tool} index={index} onClick={onClick} />
+        </Column>
+      ))}
+    </Column>
+  </AnimatedHeight>
+)
+
+const NodeBox = ({ title, icon, content, onClick }: { title: string, icon: WithIcon, content?: string, onClick?: () => void }) => (
+  <Column onClick={onClick} style={{ cursor: onClick ? 'pointer' : 'default' }}>
+    <Row gap="4px" alignItems="center">
+      <IconBox {...icon} appearance="none" colorScheme="light" size="sm" />
+      <Text className="step-index" weight="500">{title}</Text>
+    </Row>
+    <Text nowrapEllipsis color="light.700">
+      {content}
+    </Text>
+  </Column>
+)
+
+interface Props {
+  data: NodeData,
+  targetPosition?: Position,
+  sourcePosition?: Position,
+}
+
+export const NodeDynamic = ({ data, ...props }: Props) => {
+  const { step, index, onClick, onResize, message } = data
+  const content = useChatEntry(message)?.content
+  const t = useStepsDictionary()
+  const ref = useResizeObserver(onResize)
+
+  const tools = step.type === 'step' ? step?.attempts?.[0]?.tools : undefined
+
+  const renderContent = () => {
+    if (step.type === 'planning') {
+      return <NodeBox title={t.userPrompt} content={step.user_question} icon={{ ...getTypeIcon(step.type) }} />
+    }
+
+    if (step.type === 'step') {
+      return tools?.length ? <ListTools onClick={onClick} tools={tools} /> : null
+    }
+
+    if (step.type === 'answer') {
+      return <Column p={3} bg="light.400" onClick={() => onClick?.(index)}>
+        <NodeBox onClick={onClick} title={t.finalAnswer} content={content} icon={{ ...getTypeIcon(step.type) }} />     
+      </Column> 
+    }
+  }
+
+  return (
+    <div ref={ref} aria-label={getTitle(t, step, index)}>
+      <div className={listToClass(['chart-node', null, step.status])} >
+        {renderContent()}
+        <HandleGroup  {...props} renderSource={step.type !== 'answer'} renderTarget={step.type !== 'planning'} />
+      </div>
+    </div>
+  )
+}

package/src/views/Steps/FlowChart/NodeStep.tsx

@@ -1,6 +1,7 @@
 import { Icon } from '@stack-spot/citric-icons'
 import { Text } from '@stack-spot/citric-react'
 import { listToClass } from '@stack-spot/portal-theme'
+import { Position } from '@xyflow/react'
 import { StackedBadge } from '../../../components/StackedBadge'
 import { useStepsDictionary } from '../dictionary'
 import { getStatusIcon, getTitle, getTypeIcon } from '../utils'
@@ -9,15 +10,17 @@ import { NodeData } from './types'
 
 interface Props {
   data: NodeData,
+  targetPosition?: Position,
+  sourcePosition?: Position,
 }
 
-export const NodeStep = ({ data: { step, index, nextStatus, onClick } }: Props) => {
+export const NodeStep = ({ data: { step, index, nextStatus, onClick }, ...props }: Props) => {
   const t = useStepsDictionary()
 
   return (
     <div
       className={listToClass(['chart-node', step.type, nextStatus])}
-      onClick={onClick}
+      onClick={() => onClick?.()}
       onKeyDown={e => e.key === 'Enter' && onClick?.()}
       tabIndex={0}
       role="button"
@@ -41,7 +44,6 @@ export const NodeStep = ({ data: { step, index, nextStatus, onClick } }: Props)
           )}
         />}
       </div>}
-      <HandleGroup renderSource={step.type !== 'answer'} renderTarget={step.type !== 'planning'} />
-    </div>
+      <HandleGroup {...props} renderSource={step.type !== 'answer'} renderTarget={step.type !== 'planning'} />    </div>
   )
 }

package/src/views/Steps/FlowChart/hooks.ts

@@ -0,0 +1,41 @@
+import { debounce } from 'lodash'
+import { useEffect, useRef } from 'react'
+
+interface Size {
+  width: number,
+  height: number,
+}
+
+export const useResizeObserver = (callback?: (size: Size) => void, delay = 50) => {
+  const ref = useRef<HTMLDivElement | null>(null)
+  const previousSizeRef = useRef<Size | null>(null)
+
+  useEffect(() => {
+    if (!ref.current || !callback) return
+
+    const debouncedCallback = debounce((newSize: Size) => {
+      const prevSize = previousSizeRef.current
+      const hasChanged = !prevSize || prevSize.width !== newSize.width || prevSize.height !== newSize.height
+
+      if (hasChanged) {
+        previousSizeRef.current = newSize
+        callback(newSize)
+      }
+    }, delay)
+
+    const resizeObserver = new ResizeObserver((entries) => {
+      if (!entries.length) return
+      const { width, height } = entries[0].contentRect
+      debouncedCallback({ width, height })
+    })
+
+    resizeObserver.observe(ref.current)
+
+    return () => {
+      resizeObserver.disconnect()
+      debouncedCallback.cancel()
+    }
+  }, [callback])
+
+  return ref
+}

package/src/views/Steps/FlowChart/index.tsx

@@ -1,34 +1,63 @@
 import { ChatStep } from '@stack-spot/portal-network'
 import { listToClass, theme } from '@stack-spot/portal-theme'
-import { Background, Controls, Edge, MarkerType, ReactFlow } from '@xyflow/react'
+import { Background, Controls, Edge, MarkerType, ReactFlow, ReactFlowProvider, useReactFlow } from '@xyflow/react'
 import '@xyflow/react/dist/style.css'
-import { useMemo } from 'react'
+import { last } from 'lodash'
+import { useCallback, useEffect, useMemo, useState } from 'react'
 import { useChatEntry } from '../../../context/hooks'
 import { ChatEntry } from '../../../state/ChatEntry'
-import { useLayoutedElements } from './layout'
+import { LayoutDirection, useLayoutedElements } from './layout'
+import { NodeDynamic } from './NodeDynamic'
 import { NodeStep } from './NodeStep'
-import { FlowChartBox, runningColor } from './styled'
+import { FlowChartBox } from './styled'
+import { NodeFullProps } from './types'
 
 interface Props {
   message: ChatEntry,
-  onClick: (step: ChatStep, index: number) => void,
+  onClick: (step: ChatStep, toolIndex?: number) => void,
+  direction?: LayoutDirection,
 }
 
-const nodeTypes = {
-  planning: NodeStep,
-  step: NodeStep,
-  answer: NodeStep,
+const NODE_TYPES = {
+  step: { planning: NodeStep, step: NodeStep, answer: NodeStep },
+  stepDynamic: { planning: NodeDynamic, step: NodeDynamic, answer: NodeDynamic },
 }
 
-export const FlowChart = ({ message, onClick }: Props) => {
+const Flow = ({ message, onClick, direction = 'LR' }: Props) => {
   const steps = useChatEntry(message).steps
-  const { nodes, edges } = useMemo(() => {
-    const nodes = steps?.map((s, i) => ({
-      id: s.id,
-      type: s.type,
-      focusable: false,
-      data: { step: s, index: i, nextStatus: steps[i + 1]?.status, onClick: () => onClick(s, i) },
-    })) ?? []
+  const [nodeSizes, setNodeSizes] = useState<Record<string, { width: number, height: number }>>({})
+  const reactFlowInstance = useReactFlow()
+
+  const isDynamic = useMemo(() => steps?.some((step) => step.id === 'dynamic'), [steps])
+  const nodeTypes = useMemo(() => NODE_TYPES[isDynamic ? 'stepDynamic' : 'step'], [isDynamic])
+
+  const handleNodeSizeChange = useCallback((id: string, size: { width: number, height: number }) => {
+    setNodeSizes((prev) => {
+      const current = prev[id]
+      if (current?.width === size.width && current?.height === size.height) return prev
+      return { ...prev, [id]: size }
+    })
+  }, [])
+
+  const baseElements = useMemo(() => {
+    const nodes = steps?.map((s, index) => {
+      const nodeSize = nodeSizes[s.id]
+      return {
+        id: s.id,
+        type: s.type,
+        focusable: false,
+        ...(nodeSize && { width: nodeSize.width, height: nodeSize.height }),
+        origin: [1, 0],
+        data: {
+          message,
+          step: s,
+          index,
+          nextStatus: steps[index + 1]?.status,
+          onClick: (toolIndex) => onClick(s, toolIndex),
+          onResize: (size) => handleNodeSizeChange(s.id, size),
+        },
+      }
+    }) as NodeFullProps[] ?? []
     const edges: Edge[] = []
     for (let i = 0; i < nodes.length - 1; i++) {
       edges.push({
@@ -40,24 +69,33 @@ export const FlowChart = ({ message, onClick }: Props) => {
         markerEnd: {
           type: MarkerType.Arrow,
           strokeWidth: 2,
-          color: nodes[i]?.data?.nextStatus === 'running' ? runningColor : theme.color.light[700],
+          color: theme.color.light[700],
         },
       })
     }
     return { nodes, edges }
-  }, [steps])
+  }, [steps, nodeSizes, message, onClick, handleNodeSizeChange])
+
+  const { nodes, edges } = useLayoutedElements(baseElements.nodes, baseElements.edges, direction)
 
-  const layouted = useLayoutedElements(nodes, edges)
+  useEffect(() => {
+    const lastNode = last(nodes)
+    const isRunning = lastNode?.data?.step?.status === 'running'
+    const shouldFitView = nodes.length > 2 && isRunning || (lastNode?.height ?? 0 > 180) && isRunning
+    if (shouldFitView) {
+      reactFlowInstance.fitView({ duration: 1000,  padding: { bottom: '120px', top: '20px' } })
+    }
+  }, [nodes, edges, reactFlowInstance])
 
   return (
     <FlowChartBox>
       <ReactFlow
-        // @ts-ignore wrong type in the lib
-        nodes={layouted.nodes}
-        edges={layouted.edges}
+        nodes={nodes}
+        edges={edges}
         nodeTypes={nodeTypes}
         snapToGrid={true}
         fitView
+        maxZoom={1}
       >
         <Controls orientation="horizontal" className="controls" showInteractive={false} />
         <Background />
@@ -65,3 +103,9 @@ export const FlowChart = ({ message, onClick }: Props) => {
     </FlowChartBox>
   )
 }
+
+export const FlowChart = (props: Props) => (
+  <ReactFlowProvider>
+    <Flow {...props} />
+  </ReactFlowProvider>
+)

package/src/views/Steps/FlowChart/layout.ts

@@ -1,8 +1,8 @@
 import dagre from '@dagrejs/dagre'
-import { Edge } from '@xyflow/react'
+import { Edge, Position } from '@xyflow/react'
 import { useMemo } from 'react'
 import { answerNodeSize, planningNodeSize, stepNodeSize } from './styled'
-import { NodeWithoutLayout } from './types'
+import { NodeFullProps } from './types'
 
 const nodesSizes = {
   step: stepNodeSize,
@@ -11,40 +11,63 @@ const nodesSizes = {
   tool: stepNodeSize,
 }
 
-export function useLayoutedElements(nodes: NodeWithoutLayout[], edges: Edge[]) {
+export type LayoutDirection = 'TB' | 'BT' | 'LR' | 'RL'
+
+const getHandlePositions = (direction: LayoutDirection) => {
+  switch (direction) {
+    case 'TB':
+      return { target: Position.Top, source: Position.Bottom }
+    case 'BT':
+      return { target: Position.Bottom, source: Position.Top }
+    case 'LR':
+      return { target: Position.Left, source: Position.Right }
+    case 'RL':
+      return { target: Position.Right, source: Position.Left }
+  }
+}
+
+export function useLayoutedElements(nodes: NodeFullProps[], edges: Edge[], direction: LayoutDirection = 'LR') {
   const dagreGraph = useMemo(() => new dagre.graphlib.Graph().setDefaultEdgeLabel(() => ({})), [])
+
   return useMemo(() => {
-    dagreGraph.setGraph({ rankdir: 'LR' })
-    
+    dagreGraph.setGraph({ rankdir: direction })
+
     nodes.forEach((node) => {
       const { width, height } = nodesSizes[node.type]
-      dagreGraph.setNode(node.id, { width, height })
+      const nodeWidth = node.width ?? width
+      const nodeHeight = node.height ?? height
+      dagreGraph.setNode(node.id, { width: nodeWidth, height: nodeHeight })
     })
-  
+
     edges.forEach((edge) => {
       dagreGraph.setEdge(edge.source, edge.target)
     })
-  
+
     dagre.layout(dagreGraph)
-  
-    const newNodes = nodes.map((node) => {
+
+    const { target, source } = getHandlePositions(direction)
+
+    const newNodes: NodeFullProps[] = nodes.map((node) => {
       const { width, height } = nodesSizes[node.type]
+      const nodeWidth = node?.width ?? width
+      const nodeHeight = node.height ?? height
       const nodeWithPosition = dagreGraph.node(node.id)
       const newNode = {
         ...node,
-        targetPosition: 'left',
-        sourcePosition: 'right',
+        targetPosition: target,
+        sourcePosition: source,
         // We are shifting the dagre node position (anchor=center center) to the top left
         // so it matches the React Flow node anchor point (top left).
         position: {
-          x: nodeWithPosition.x - width / 2,
-          y: nodeWithPosition.y - height / 2,
+          x: nodeWithPosition.x - nodeWidth / 2,
+          y: nodeWithPosition.y - nodeHeight / 2,
         },
       }
-  
+
       return newNode
     })
-  
+
     return { nodes: newNodes, edges }
   }, [nodes, edges])
 }
+