Function useAgentflow

packages/agentflow/src/useAgentflow.ts:38–138

()

 * ```
 */
export function useAgentflow(): AgentFlowInstance {
    const { state, setNodes, setEdges, setDirty, getFlowData, setNodeExecutionStatus, clearExecutionState } = useAgentflowContext()

    const { nodes, edges, reactFlowInstance } = state

    /**
     * Get the current flow data as a serializable object
     */
    const getFlow = useCallback((): FlowData => {
        return getFlowData()
    }, [getFlowData])

    /**
     * Convert the current flow to a JSON string
     */
    const toJSON = useCallback((): string => {
        return JSON.stringify(getFlowData(), null, 2)
    }, [getFlowData])

    /**
     * Validate the current flow structure
     */
    const validate = useCallback((): ValidationResult => {
        return validateFlow(nodes, edges)
    }, [nodes, edges])

    /**
     * Fit the canvas view to show all nodes
     */
    const fitView = useCallback((): void => {
        reactFlowInstance?.fitView({ padding: 0.2, duration: 200 })
    }, [reactFlowInstance])

    /**
     * Get the underlying ReactFlow instance
     */
    const getReactFlowInstance = useCallback(() => {
        return reactFlowInstance
    }, [reactFlowInstance])

    /**
     * Programmatically add a new node to the canvas
     */
    const addNode = useCallback(
        (nodeData: Partial<FlowNode>): void => {
            const newNode: FlowNode = {
                id: nodeData.id || `node_${Date.now()}`,
                type: nodeData.type || 'agentFlow',
                position: nodeData.position || { x: 100, y: 100 },
                data: nodeData.data || { name: '', label: '' },
                ...nodeData
            } as FlowNode

            setNodes([...nodes, newNode])
            setDirty(true)
        },
        [nodes, setNodes, setDirty]
    )