Waldiez

@classmethod
def from_dict(
    cls,
    data: Dict[str, Any],
    flow_id: Optional[str] = None,
    name: Optional[str] = None,
    description: Optional[str] = None,
    tags: Optional[List[str]] = None,
    requirements: Optional[List[str]] = None,
) -> "Waldiez":
    """Create a Waldiez from dict.

    Parameters
    ----------
    data : Dict[str, Any]
        The data.
    flow_id : Optional[str], optional
        The flow id, by default None (retrieved from data or generated).
    name : Optional[str], optional
        The name, by default None (retrieved from data).
    description : Optional[str], optional
        The description, by default None (retrieved from data).
    tags : Optional[List[str]], optional
        The tags, by default None (retrieved from data).
    requirements : Optional[List[str]], optional
        The requirements, by default None (retrieved from data).

    Returns
    -------
    Waldiez
        The Waldiez.
    """
    flow = get_flow_data(
        data,
        flow_id=flow_id,
        name=name,
        description=description,
        tags=tags,
        requirements=requirements,
    )
    return cls(flow=WaldiezFlow.model_validate(flow))

def get_flow_env_vars(self) -> List[Tuple[str, str]]:
    """Get the flow environment variables.

    Returns
    -------
    List[Tuple[str, str]]
        The environment variables for the flow.
    """
    env_vars: List[Tuple[str, str]] = []
    for skill in self.skills:
        for secret_key, secret_value in skill.secrets.items():
            env_vars.append((secret_key, secret_value))
    return env_vars

def get_group_chat_members(self, agent: WaldiezAgent) -> List[WaldiezAgent]:
    """Get the chat members that connect to a group chat manager agent.

    Parameters
    ----------
    agent : WaldiezAgent
        The agent (group chat manager).

    Returns
    -------
    List[WaldiezAgent]
        The group chat members.
    """
    if agent.agent_type != "manager":
        return []
    return self.flow.get_group_chat_members(agent.id)

def get_swarm_members(
    self, initial_agent: WaldiezAgent
) -> Tuple[List[WaldiezAgent], Optional[WaldiezAgent]]:
    """Get the chat members that connect to a swarm agent.

    Parameters
    ----------
    initial_agent : WaldiezAgent
        The initial agent.

    Returns
    -------
    Tuple[List[WaldiezAgent], Optional[WaldiezAgent]]
        The swarm agents and the user agent.
    """
    return self.flow.get_swarm_chat_members(initial_agent)

@classmethod
def load(
    cls,
    waldiez_file: Union[str, Path],
    name: Optional[str] = None,
    description: Optional[str] = None,
    tags: Optional[List[str]] = None,
    requirements: Optional[List[str]] = None,
) -> "Waldiez":
    """Load a Waldiez from a file.

    Parameters
    ----------
    waldiez_file : Union[str, Path]
        The Waldiez file.
    name : Optional[str], optional
        The name, by default None.
    description : Optional[str], optional
        The description, by default None.
    tags : Optional[List[str]], optional
        The tags, by default None.
    requirements : Optional[List[str]], optional
        The requirements, by default None.

    Returns
    -------
    Waldiez
        The Waldiez.

    Raises
    ------
    ValueError
        If the file is not found or invalid JSON.
    """
    data: Dict[str, Any] = {}
    if not Path(waldiez_file).exists():
        raise ValueError(f"File not found: {waldiez_file}")
    with open(waldiez_file, "r", encoding="utf-8") as file:
        try:
            data = json.load(file)
        except json.decoder.JSONDecodeError as error:
            raise ValueError(f"Invalid JSON: {waldiez_file}") from error
    return cls.from_dict(
        data,
        name=name,
        description=description,
        tags=tags,
        requirements=requirements,
    )

def model_dump_json(
    self, by_alias: bool = True, indent: Optional[int] = None
) -> str:
    """Get the model dump json.

    We use `by_alias=True` by default to use the alias (toCamel).

    Parameters
    ----------
    by_alias : bool, optional
        Use alias (toCamel), by default True.
    indent : Optional[int], optional
        The indent, by default None.

    Returns
    -------
    str
        The model dump json.
    """
    return self.flow.model_dump_json(by_alias=by_alias, indent=indent)