sapiopycommons 2025.5.12a521__py3-none-any.whl → 2025.5.13a523__py3-none-any.whl

sapiopycommons/ai/tool_service_base.py

@@ -437,8 +437,8 @@ class ToolBase(ABC):
         """
         self.configs.append(ProtobufUtils.field_def_to_pbo(field))
 
-    def add_boolean_config_field(self, field_name: str, display_name: str, description: str, default_value: bool) \
-            -> None:
+    def add_boolean_config_field(self, field_name: str, display_name: str, description: str, default_value: bool,
+                                 optional: bool = False) -> None:
         """
         Add a boolean configuration field to the tool. This field will be used to configure the tool in the plan
         manager.
@@ -447,13 +447,14 @@ class ToolBase(ABC):
         :param display_name: The display name of the field.
         :param description: The description of the field.
         :param default_value: The default value of the field.
+        :param optional: If true, this field is optional. If false, this field is required.
         """
         self.configs.append(VeloxFieldDefPbo(
             data_field_type=FieldTypePbo.BOOLEAN,
             data_field_name=field_name,
             display_name=display_name,
             description=description,
-            required=True,
+            required=not optional,
             editable=True,
             boolean_properties=BooleanPropertiesPbo(
                 default_value=default_value
@@ -461,7 +462,8 @@ class ToolBase(ABC):
         ))
 
     def add_double_config_field(self, field_name: str, display_name: str, description: str, default_value: float,
-                                min_value: float = -10.**120, max_value: float = 10.**120, precision: int = 2) -> None:
+                                min_value: float = -10.**120, max_value: float = 10.**120, precision: int = 2,
+                                optional: bool = False) -> None:
         """
         Add a double configuration field to the tool. This field will be used to configure the tool in the plan
         manager.
@@ -473,13 +475,14 @@ class ToolBase(ABC):
         :param min_value: The minimum value of the field.
         :param max_value: The maximum value of the field.
         :param precision: The precision of the field.
+        :param optional: If true, this field is optional. If false, this field is required.
         """
         self.configs.append(VeloxFieldDefPbo(
             data_field_type=FieldTypePbo.DOUBLE,
             data_field_name=field_name,
             display_name=display_name,
             description=description,
-            required=True,
+            required=not optional,
             editable=True,
             double_properties=DoublePropertiesPbo(
                 default_value=default_value,
@@ -490,7 +493,8 @@ class ToolBase(ABC):
         ))
 
     def add_integer_config_field(self, field_name: str, display_name: str, description: str,
-                                 default_value: int, min_value: int = -2**31, max_value: int = 2**31-1) -> None:
+                                 default_value: int, min_value: int = -2**31, max_value: int = 2**31-1,
+                                 optional: bool = False) -> None:
         """
         Add an integer configuration field to the tool. This field will be used to configure the tool in the plan
         manager.
@@ -501,13 +505,14 @@ class ToolBase(ABC):
         :param default_value: The default value of the field.
         :param min_value: The minimum value of the field.
         :param max_value: The maximum value of the field.
+        :param optional: If true, this field is optional. If false, this field is required.
         """
         self.configs.append(VeloxFieldDefPbo(
             data_field_type=FieldTypePbo.INTEGER,
             data_field_name=field_name,
             display_name=display_name,
             description=description,
-            required=True,
+            required=not optional,
             editable=True,
             integer_properties=IntegerPropertiesPbo(
                 default_value=default_value,
@@ -517,7 +522,7 @@ class ToolBase(ABC):
         ))
 
     def add_string_config_field(self, field_name: str, display_name: str, description: str,
-                                default_value: str, max_length: int = 1000) -> None:
+                                default_value: str, max_length: int = 1000, optional: bool = False) -> None:
         """
         Add a string configuration field to the tool. This field will be used to configure the tool in the plan
         manager.
@@ -527,13 +532,14 @@ class ToolBase(ABC):
         :param description: The description of the field.
         :param default_value: The default value of the field.
         :param max_length: The maximum length of the field.
+        :param optional: If true, this field is optional. If false, this field is required.
         """
         self.configs.append(VeloxFieldDefPbo(
             data_field_type=FieldTypePbo.STRING,
             data_field_name=field_name,
             display_name=display_name,
             description=description,
-            required=True,
+            required=not optional,
             editable=True,
             string_properties=StringPropertiesPbo(
                 default_value=default_value,
@@ -542,7 +548,7 @@ class ToolBase(ABC):
         ))
 
     def add_list_config_field(self, field_name: str, display_name: str, description: str, default_value: str,
-                              allowed_values: list[str], direct_edit: bool = False) -> None:
+                              allowed_values: list[str], direct_edit: bool = False, optional: bool = False) -> None:
         """
         Add a list configuration field to the tool. This field will be used to configure the tool in the plan
         manager.
@@ -554,13 +560,14 @@ class ToolBase(ABC):
         :param allowed_values: The list of allowed values for the field.
         :param direct_edit: If true, the user can enter a value that is not in the list of allowed values. If false,
             the user can only select from the list of allowed values.
+        :param optional: If true, this field is optional. If false, this field is required.
         """
         self.configs.append(VeloxFieldDefPbo(
             data_field_type=FieldTypePbo.SELECTION,
             data_field_name=field_name,
             display_name=display_name,
             description=description,
-            required=True,
+            required=not optional,
             editable=True,
             selection_properties=SelectionPropertiesPbo(
                 default_value=default_value,
@@ -570,8 +577,8 @@ class ToolBase(ABC):
         ))
 
     def add_multi_list_config_field(self, field_name: str, display_name: str, description: str,
-                                    default_value: list[str], allowed_values: list[str], direct_edit: bool = False) \
-            -> None:
+                                    default_value: list[str], allowed_values: list[str], direct_edit: bool = False,
+                                    optional: bool = False) -> None:
         """
         Add a multi-select list configuration field to the tool. This field will be used to configure the tool in the
         plan manager.
@@ -583,13 +590,14 @@ class ToolBase(ABC):
         :param allowed_values: The list of allowed values for the field.
         :param direct_edit: If true, the user can enter a value that is not in the list of allowed values. If false,
             the user can only select from the list of allowed values.
+        :param optional: If true, this field is optional. If false, this field is required.
         """
         self.configs.append(VeloxFieldDefPbo(
             data_field_type=FieldTypePbo.SELECTION,
             data_field_name=field_name,
             display_name=display_name,
             description=description,
-            required=True,
+            required=not optional,
             editable=True,
             selection_properties=SelectionPropertiesPbo(
                 default_value=",".join(default_value),

{sapiopycommons-2025.5.12a521.dist-info → sapiopycommons-2025.5.13a523.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sapiopycommons
-Version: 2025.5.12a521
+Version: 2025.5.13a523
 Summary: Official Sapio Python API Utilities Package
 Project-URL: Homepage, https://github.com/sapiosciences
 Author-email: Jonathan Steck <jsteck@sapiosciences.com>, Yechen Qiao <yqiao@sapiosciences.com>

{sapiopycommons-2025.5.12a521.dist-info → sapiopycommons-2025.5.13a523.dist-info}/RECORD

@@ -1,7 +1,7 @@
 sapiopycommons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sapiopycommons/ai/protobuf_utils.py,sha256=aKmZtNLrrzUe_LFsdW0zYpG4VI-ZGgukyXVDFtIqfes,22656
-sapiopycommons/ai/tool_service_base.py,sha256=h9XtvPKaDBCVE9a6oRVU7ZkvqJhUPO9U0VaHX76JhXM,33728
+sapiopycommons/ai/tool_service_base.py,sha256=adsC1kesRZJGdUmvcp1KrXgQ1RuLE7OMnPwRUsaP8DM,34578
 sapiopycommons/ai/api/fielddefinitions/proto/fields_pb2.py,sha256=YcZjb_YM-XeLErM8hEC_S7vGMVGvcXAMGs2b-u5zvOE,2377
 sapiopycommons/ai/api/fielddefinitions/proto/fields_pb2.pyi,sha256=FwtXmNAf7iYGEFm4kbqb04v77jNHbZg18ZmEDhle_bU,1444
 sapiopycommons/ai/api/fielddefinitions/proto/fields_pb2_grpc.py,sha256=wPImJPdCUZNVEVoUWzsba9kGIXjEKPdUkawP5SnVyiU,932
@@ -85,7 +85,7 @@ sapiopycommons/webhook/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 sapiopycommons/webhook/webhook_context.py,sha256=D793uLsb1691SalaPnBUk3rOSxn_hYLhdvkaIxjNXss,1909
 sapiopycommons/webhook/webhook_handlers.py,sha256=L0HetSm43NvA5KyW3xbLpGFh2DbAaeZJVtXIEl2fvV8,39689
 sapiopycommons/webhook/webservice_handlers.py,sha256=Y5dHx_UFWFuSqaoPL6Re-fsKYRuxvCWZ8bj6KSZ3jfM,14285
-sapiopycommons-2025.5.12a521.dist-info/METADATA,sha256=NDAG-QmrZ4B1l_8ZVl6iaEHGA296uwg7PL5sHF6uEoA,3143
-sapiopycommons-2025.5.12a521.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-sapiopycommons-2025.5.12a521.dist-info/licenses/LICENSE,sha256=HyVuytGSiAUQ6ErWBHTqt1iSGHhLmlC8fO7jTCuR8dU,16725
-sapiopycommons-2025.5.12a521.dist-info/RECORD,,
+sapiopycommons-2025.5.13a523.dist-info/METADATA,sha256=QqPGY0nDOqra3OvNj_CbyA5SNwYfSzf8DOZm1HbjPfo,3143
+sapiopycommons-2025.5.13a523.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+sapiopycommons-2025.5.13a523.dist-info/licenses/LICENSE,sha256=HyVuytGSiAUQ6ErWBHTqt1iSGHhLmlC8fO7jTCuR8dU,16725
+sapiopycommons-2025.5.13a523.dist-info/RECORD,,