Method from_dict

entity/messages.py:347–396

(cls, data: Dict[str, Any])

    @classmethod
    def from_dict(cls, data: Dict[str, Any]) -> "Message":
        role_value = data.get("role")
        if not role_value:
            raise ValueError("message dict missing role")
        role = MessageRole(role_value)
        content = data.get("content")
        if isinstance(content, list):
            converted: List[MessageBlock] = []
            for block in content:
                if isinstance(block, MessageBlock):
                    converted.append(block)
                elif isinstance(block, dict):
                    try:
                        converted.append(MessageBlock.from_dict(block))
                    except Exception:
                        # Preserve raw dict for debugging; text_content will stringify best-effort
                        converted.append(
                            MessageBlock(
                                type=MessageBlockType.DATA,
                                text=str(block),
                                data=block,
                            )
                        )
            content = converted
        tool_calls_data = data.get("tool_calls") or []
        tool_calls: List[ToolCallPayload] = []
        for item in tool_calls_data:
            if not isinstance(item, dict):
                continue
            fn = item.get("function", {}) or {}
            metadata = item.get("metadata") or {}
            tool_calls.append(
                ToolCallPayload(
                    id=item.get("id", ""),
                    function_name=fn.get("name", ""),
                    arguments=fn.get("arguments", ""),
                    type=item.get("type", "function"),
                    metadata=metadata,
                )
            )
        return cls(
            role=role,
            content=content,
            name=data.get("name"),
            tool_call_id=data.get("tool_call_id"),
            metadata=data.get("metadata") or {},
            tool_calls=tool_calls,
            keep=bool(data.get("keep", False)),
            preserve_role=bool(data.get("preserve_role", False)),
        )


def serialize_messages(messages: List[Message], *, include_data: bool = True) -> str: