splunk-soar-sdk 2.3.6__py3-none-any.whl → 3.0.0__py3-none-any.whl

soar_sdk/cli/manifests/deserializers.py

@@ -1,7 +1,7 @@
 import dataclasses
 import json
 from pathlib import Path
-from typing import Any, NamedTuple, Optional, TypeVar, Union, cast
+from typing import Any, NamedTuple, TypeVar, cast
 import pydantic
 
 from soar_sdk.action_results import ActionOutput, OutputFieldSpecification, OutputField
@@ -94,10 +94,10 @@ class OutputFieldModel:
 
     data_path: str
     data_type: str
-    contains: Optional[list[str]] = None
-    example_values: Optional[list[Union[str, float, bool]]] = None
-    column_name: Optional[str] = None
-    column_order: Optional[int] = None
+    contains: list[str] | None = None
+    example_values: list[str | float | bool] | None = None
+    column_name: str | None = None
+    column_order: int | None = None
 
 
 class DeserializedActionMeta(NamedTuple):
@@ -129,7 +129,7 @@ class ActionDeserializer:
         )
         action["output"] = cls.parse_output(action["action"], action.get("output", []))
         return DeserializedActionMeta(
-            action_meta=ActionMeta.parse_obj(action),
+            action_meta=ActionMeta.model_validate(action),
             has_custom_view=action.get("render", {}).get("type") == "custom",
         )
 
@@ -212,7 +212,7 @@ class ActionDeserializer:
     @staticmethod
     def _build_output_structure(
         datapath_specs: dict[str, OutputFieldModel],
-    ) -> dict[str, Union[list, dict, OutputFieldModel]]:
+    ) -> dict[str, list | dict | OutputFieldModel]:
         """Parse a datapath string into a dictionary.
 
         Args:
@@ -223,10 +223,10 @@ class ActionDeserializer:
         """
 
         def set_nested_value(
-            field_struct: dict[str, Union[list, dict, OutputFieldModel]],
+            field_struct: dict[str, list | dict | OutputFieldModel],
             path_parts: list[str],
             field_spec: OutputFieldModel,
-        ) -> Union[list, dict, OutputFieldModel]:
+        ) -> list | dict | OutputFieldModel:
             """Recursively set a field spec in the nested output field structure."""
             # Base case: we're at a leaf node and can return the field spec directly
             if not path_parts:
@@ -240,7 +240,7 @@ class ActionDeserializer:
 
             # Recursive case: this portion of the datapath is an object key
             next_field_struct = cast(
-                dict[str, Union[list, dict, OutputFieldModel]],
+                dict[str, list | dict | OutputFieldModel],
                 field_struct.get(current_key, {}),
             )
             field_struct[current_key] = set_nested_value(
@@ -248,7 +248,7 @@ class ActionDeserializer:
             )
             return field_struct
 
-        MergeT = TypeVar("MergeT", bound=Union[list, dict, OutputFieldModel])
+        MergeT = TypeVar("MergeT", bound=list | dict | OutputFieldModel)
 
         def merge(base: MergeT, new_structure: MergeT) -> MergeT:
             """Merge two nested structures, handling arrays and objects."""
@@ -280,12 +280,12 @@ class ActionDeserializer:
             # Should never happen in reality, hence the pragma, but we handle it gracefully
             return new_structure  # pragma: no cover
 
-        result: dict[str, Union[list, dict, OutputFieldModel]] = {}
+        result: dict[str, list | dict | OutputFieldModel] = {}
 
         for datapath, field_spec in datapath_specs.items():
             path_parts = datapath.split(".")
             nested_structure = cast(
-                dict[str, Union[list, dict, OutputFieldModel]],
+                dict[str, list | dict | OutputFieldModel],
                 set_nested_value({}, path_parts, field_spec),
             )
             merged = merge(result, nested_structure)
@@ -298,7 +298,7 @@ class ActionDeserializer:
     def _build_output_class(
         cls,
         action_name: str,
-        output_structure: dict[str, Union[dict, list, OutputFieldModel]],
+        output_structure: dict[str, dict | list | OutputFieldModel],
     ) -> type[ActionOutput]:
         """Build dynamic pydantic models for an action output, from the output data paths.
 
@@ -323,7 +323,7 @@ class ActionDeserializer:
 
     @classmethod
     def _build_output_field(
-        cls, field_name: str, output_structure: Union[list, dict, OutputFieldModel]
+        cls, field_name: str, output_structure: list | dict | OutputFieldModel
     ) -> tuple[str, FieldSpec]:
         """Build dynamic specs for an action output field, from an output data path.
 

soar_sdk/cli/manifests/processors.py

@@ -1,13 +1,13 @@
 import importlib
 import json
 import toml
-from datetime import datetime, timezone
+from datetime import datetime, UTC
 from pathlib import Path
 from pprint import pprint
 
 from soar_sdk.app import App
 from soar_sdk.cli.path_utils import context_directory
-from soar_sdk.compat import remove_when_soar_newer_than, UPDATE_TIME_FORMAT
+from soar_sdk.compat import UPDATE_TIME_FORMAT
 from soar_sdk.meta.adapters import TOMLDataAdapter
 from soar_sdk.meta.app import AppMeta
 from soar_sdk.meta.dependencies import UvLock
@@ -30,9 +30,7 @@ class ManifestProcessor:
         app = self.import_app_instance(app_meta)
         app_meta.configuration = app.asset_cls.to_json_schema()
         app_meta.actions = app.actions_manager.get_actions_meta_list()
-        app_meta.utctime_updated = datetime.now(timezone.utc).strftime(
-            UPDATE_TIME_FORMAT
-        )
+        app_meta.utctime_updated = datetime.now(UTC).strftime(UPDATE_TIME_FORMAT)
         for field, value in app.app_meta_info.items():
             setattr(app_meta, field, value)
 
@@ -43,16 +41,12 @@ class ManifestProcessor:
                 dep for dep in dependencies if dep.name != "splunk-soar-sdk"
             ]
 
-        app_meta.pip39_dependencies, app_meta.pip313_dependencies = (
+        app_meta.pip313_dependencies, app_meta.pip314_dependencies = (
             uv_lock.resolve_dependencies(dependencies)
         )
 
         if app.webhook_meta is not None:
-            remove_when_soar_newer_than("6.4.0")
             app_meta.webhook = app.webhook_meta
-            app_meta.webhook.handler = (
-                f"{app_meta.main_module.replace(':', '.')}.handle_webhook"
-            )
 
         return app_meta
 

soar_sdk/cli/manifests/serializers.py

@@ -1,4 +1,4 @@
-from typing import Any, Optional
+from typing import Any
 from collections.abc import Iterator
 from logging import getLogger
 import itertools
@@ -6,6 +6,7 @@ import itertools
 from soar_sdk.meta.datatypes import as_datatype
 from soar_sdk.params import Params
 from soar_sdk.action_results import ActionOutput, OutputFieldSpecification
+from soar_sdk.field_utils import parse_json_schema_extra
 
 logger = getLogger(__name__)
 
@@ -16,7 +17,7 @@ class ParamsSerializer:
     @staticmethod
     def get_sorted_fields_keys(params_class: type[Params]) -> list[str]:
         """Lists the fields of a Params class in order of declaration."""
-        return list(params_class.__fields__.keys())
+        return list(params_class.model_fields.keys())
 
     @classmethod
     def serialize_fields_info(cls, params_class: type[Params]) -> dict[str, Any]:
@@ -30,21 +31,28 @@ class OutputsSerializer:
     @staticmethod
     def serialize_parameter_datapaths(
         params_class: type[Params],
-        column_order_counter: Optional[itertools.count] = None,
+        column_order_counter: itertools.count | None = None,
     ) -> Iterator[OutputFieldSpecification]:
         """Serializes the parameter data paths of a Params class to JSON schema."""
         if column_order_counter is None:
             column_order_counter = itertools.count()
 
-        for field_name, field in params_class.__fields__.items():
+        for field_name, field in params_class.model_fields.items():
+            annotation = field.annotation
+            if annotation is None:
+                continue
+
             spec = OutputFieldSpecification(
                 data_path=f"action_result.parameter.{field_name}",
-                data_type=as_datatype(field.annotation),
+                data_type=as_datatype(annotation),
             )
-            if cef_types := field.field_info.extra.get("cef_types"):
+
+            json_schema_extra = parse_json_schema_extra(field.json_schema_extra)
+
+            if cef_types := json_schema_extra.get("cef_types"):
                 spec["contains"] = cef_types
 
-            column_name = field.field_info.extra.get("column_name")
+            column_name = json_schema_extra.get("column_name")
 
             if column_name is not None:
                 spec["column_name"] = column_name
@@ -56,7 +64,7 @@ class OutputsSerializer:
         cls,
         params_class: type[Params],
         outputs_class: type[ActionOutput],
-        summary_class: Optional[type[ActionOutput]] = None,
+        summary_class: type[ActionOutput] | None = None,
     ) -> list[OutputFieldSpecification]:
         """Serializes the data paths of an action to JSON schema."""
         status = OutputFieldSpecification(

soar_sdk/cli/package/cli.py

@@ -9,7 +9,7 @@ import json
 from pathlib import Path
 import asyncio
 import time
-from typing import Optional, Annotated
+from typing import Annotated
 from tqdm import tqdm
 from rich.console import Console
 from rich.panel import Panel
@@ -67,11 +67,11 @@ def build(
         ),
     ],
     output_file: Annotated[
-        Optional[Path],
+        Path | None,
         typer.Option("--output-file", "-o", show_default="derived from pyproject.toml"),
     ] = None,
     with_sdk_wheel_from: Annotated[
-        Optional[Path],
+        Path | None,
         typer.Option(
             "--with-sdk-wheel-from",
             "-w",
@@ -115,7 +115,7 @@ def build(
 
         console.print(f"Generated manifest for app:[green] {app_name}[/]")
 
-        def filter_source_files(t: tarfile.TarInfo) -> Optional[tarfile.TarInfo]:
+        def filter_source_files(t: tarfile.TarInfo) -> tarfile.TarInfo | None:
             if t.isdir() and "__pycache__" not in t.name:
                 return t
             if t.isfile() and t.name.endswith(".py"):
@@ -125,7 +125,7 @@ def build(
         with tarfile.open(output_file, "w:gz") as app_tarball:
             # Collect all wheels from both Python versions
             all_wheels = set(
-                app_meta.pip39_dependencies.wheel + app_meta.pip313_dependencies.wheel
+                app_meta.pip313_dependencies.wheel + app_meta.pip314_dependencies.wheel
             )
 
             # Run the async collection function within an event loop
@@ -188,8 +188,8 @@ def build(
                     input_file=wheel_archive_path,
                     input_file_aarch64=wheel_archive_path,
                 )
-                app_meta.pip39_dependencies.wheel.append(wheel_entry)
                 app_meta.pip313_dependencies.wheel.append(wheel_entry)
+                app_meta.pip314_dependencies.wheel.append(wheel_entry)
 
             console.print("Writing manifest")
             manifest_json = json.dumps(app_meta.to_json_manifest(), indent=4).encode()

soar_sdk/cli/package/utils.py

@@ -6,7 +6,7 @@ from collections.abc import AsyncGenerator
 @asynccontextmanager
 async def phantom_get_login_session(
     base_url: str, username: str, password: str
-) -> AsyncGenerator[httpx.AsyncClient, None]:
+) -> AsyncGenerator[httpx.AsyncClient]:
     """Contextmanager that creates an authenticated client with CSRF token handling."""
     # Set longer timeouts for large file uploads
     timeout = httpx.Timeout(30.0, read=60.0)

soar_sdk/code_renderers/action_renderer.py

@@ -1,14 +1,15 @@
-from typing import ClassVar, Optional
+from typing import ClassVar
 from collections.abc import Iterator
 import typing
 import ast
-from pydantic.fields import Undefined
+from pydantic_core import PydanticUndefined
 
 from soar_sdk.action_results import ActionOutput
 from soar_sdk.cli.utils import normalize_field_name
 from soar_sdk.code_renderers.renderer import AstRenderer
 from soar_sdk.meta.actions import ActionMeta
 from soar_sdk.params import Params
+from soar_sdk.field_utils import parse_json_schema_extra
 
 
 class ActionRenderer(AstRenderer[ActionMeta]):
@@ -201,7 +202,7 @@ class ActionRenderer(AstRenderer[ActionMeta]):
         yield ast.fix_missing_locations(node)
 
     def render_outputs_ast(
-        self, model: Optional[type[ActionOutput]] = None
+        self, model: type[ActionOutput] | None = None
     ) -> Iterator[ast.ClassDef]:
         """Generates the AST for the action outputs.
 
@@ -221,16 +222,24 @@ class ActionRenderer(AstRenderer[ActionMeta]):
 
         field_defs: list[ast.stmt] = []
 
-        for field_name_str, field in model.__fields__.items():
+        for field_name_str, field in model.model_fields.items():
             annotation = field.annotation
+            if annotation is None:
+                continue
+
             annotation_str = "{name}"
             while typing.get_origin(annotation) is list:
                 annotation_str = f"list[{annotation_str}]"
                 annotation = typing.get_args(annotation)[0]
+
+            # Ensure annotation is a valid type after unwrapping
+            if not isinstance(annotation, type):
+                continue
+
             annotation_str = annotation_str.format(name=annotation.__name__)
 
             field_name = normalize_field_name(field_name_str)
-            if field.alias != field_name.normalized:
+            if field.alias is not None and field.alias != field_name.normalized:
                 field_name.original = field.alias
                 field_name.modified = True
 
@@ -240,9 +249,10 @@ class ActionRenderer(AstRenderer[ActionMeta]):
                 simple=1,
             )
 
-            if issubclass(annotation, ActionOutput):
+            if isinstance(annotation, type) and issubclass(annotation, ActionOutput):
                 # If the field is a Pydantic model, recursively print its fields
-                for model_ast in self.render_outputs_ast(field.type_):
+                # In Pydantic v2, use annotation directly (no field.type_)
+                for model_ast in self.render_outputs_ast(annotation):
                     model_tree[model_ast.name] = model_ast
 
                 if field_name.modified:
@@ -258,7 +268,9 @@ class ActionRenderer(AstRenderer[ActionMeta]):
                     )
             else:
                 keywords = []
-                if (extras := {**field.field_info.extra}) or field_name.modified:
+                extras = {**parse_json_schema_extra(field.json_schema_extra)}
+
+                if extras or field_name.modified:
                     extras["example_values"] = extras.pop("examples", None)
                     if extras["example_values"] == [True, False]:
                         extras["example_values"] = None
@@ -315,7 +327,10 @@ class ActionRenderer(AstRenderer[ActionMeta]):
             keywords=[],
         )
 
-        for field_name, field_def in self.action_meta.parameters.__fields__.items():
+        for field_name, field_def in self.action_meta.parameters.model_fields.items():
+            if field_def.annotation is None:
+                continue
+
             field_type = ast.Name(id=field_def.annotation.__name__, ctx=ast.Load())
 
             param = ast.Call(
@@ -324,29 +339,31 @@ class ActionRenderer(AstRenderer[ActionMeta]):
                 keywords=[],
             )
 
-            if field_def.field_info.description:
+            json_schema_extra = parse_json_schema_extra(field_def.json_schema_extra)
+
+            if field_def.description:
                 param.keywords.append(
                     ast.keyword(
                         arg="description",
-                        value=ast.Constant(value=field_def.field_info.description),
+                        value=ast.Constant(value=field_def.description),
                     )
                 )
-            if not field_def.field_info.extra.get("required", True):
+            if not json_schema_extra.get("required", True):
                 param.keywords.append(
                     ast.keyword(arg="required", value=ast.Constant(value=False))
                 )
-            if field_def.field_info.extra.get("primary", False):
+            if json_schema_extra.get("primary", False):
                 param.keywords.append(
                     ast.keyword(arg="primary", value=ast.Constant(value=True))
                 )
-            if (default := field_def.field_info.default) and default != Undefined:
+            if field_def.default not in (PydanticUndefined, None):
                 param.keywords.append(
                     ast.keyword(
                         arg="default",
-                        value=ast.Constant(value=field_def.field_info.default),
+                        value=ast.Constant(value=field_def.default),
                     )
                 )
-            if value_list := field_def.field_info.extra.get("value_list"):
+            if value_list := json_schema_extra.get("value_list"):
                 param.keywords.append(
                     ast.keyword(
                         arg="value_list",
@@ -356,7 +373,7 @@ class ActionRenderer(AstRenderer[ActionMeta]):
                         ),
                     )
                 )
-            if cef_types := field_def.field_info.extra.get("cef_types"):
+            if cef_types := json_schema_extra.get("cef_types"):
                 param.keywords.append(
                     ast.keyword(
                         arg="cef_types",
@@ -366,7 +383,7 @@ class ActionRenderer(AstRenderer[ActionMeta]):
                         ),
                     )
                 )
-            if field_def.field_info.extra.get("allow_list", False):
+            if json_schema_extra.get("allow_list", False):
                 param.keywords.append(
                     ast.keyword(arg="allow_list", value=ast.Constant(value=True))
                 )

soar_sdk/code_renderers/app_renderer.py

@@ -1,6 +1,5 @@
 import dataclasses
 import ast
-from typing import Union
 from collections.abc import Iterator
 
 
@@ -50,7 +49,7 @@ class AppRenderer:
         self.context = context
 
     @staticmethod
-    def create_default_imports() -> Iterator[Union[ast.Import, ast.ImportFrom]]:
+    def create_default_imports() -> Iterator[ast.Import | ast.ImportFrom]:
         """Create default imports for the App module.
 
         Returns:

soar_sdk/code_renderers/asset_renderer.py

@@ -1,5 +1,4 @@
 import dataclasses
-from typing import Optional, Union
 import ast
 from collections.abc import Iterator
 
@@ -12,12 +11,12 @@ class AssetContext:
     """Context for rendering individual configuration keys of an Asset class."""
 
     name: str
-    description: Optional[str]
+    description: str | None
     required: bool
-    default: Union[str, int, float, bool, None]
+    default: str | int | float | bool | None
     data_type: str
-    value_list: Optional[list[str]]
-    alias: Optional[str] = None
+    value_list: list[str] | None
+    alias: str | None = None
 
     @property
     def is_str(self) -> bool:

soar_sdk/code_renderers/renderer.py

@@ -1,5 +1,5 @@
 import abc
-from typing import TypeVar, Generic, Optional
+from typing import TypeVar, Generic
 import jinja2 as j2
 import ast
 from collections.abc import Iterator
@@ -12,7 +12,7 @@ class Renderer(Generic[ContextT], abc.ABC):
     """Abstract base class for rendering code using Jinja2 templates."""
 
     def __init__(
-        self, context: ContextT, jinja_env: Optional[j2.Environment] = None
+        self, context: ContextT, jinja_env: j2.Environment | None = None
     ) -> None:
         self.context = context
         self.jinja_env = jinja_env or j2.Environment(

soar_sdk/code_renderers/templates/pyproject.toml.jinja

@@ -52,7 +52,7 @@ required-environments = [
 [tool.ruff]
 output-format = "full"  # <full|concise>
 fix = true
-target-version = "py39"
+target-version = "py313"
 
 [tool.ruff.lint]
 select = [

soar_sdk/compat.py

@@ -2,7 +2,7 @@ from enum import Enum
 import functools
 from packaging.version import Version
 
-MIN_PHANTOM_VERSION = "6.4.0"
+MIN_PHANTOM_VERSION = "7.0.0"
 
 UPDATE_TIME_FORMAT = "%Y-%m-%dT%H:%M:%S.%fZ"
 
@@ -27,8 +27,8 @@ def remove_when_soar_newer_than(
 class PythonVersion(str, Enum):
     """Enum to represent supported Python versions."""
 
-    PY_3_9 = "3.9"
     PY_3_13 = "3.13"
+    PY_3_14 = "3.14"
 
     def __str__(self) -> str:
         """Returns the string representation of the Python version."""
@@ -41,10 +41,10 @@ class PythonVersion(str, Enum):
         Raises ValueError if the version is not supported.
         """
         # "3" is a special case for connectors that don't properly define their Python version
-        if version_str in ("3", "3.9"):
-            return cls.PY_3_9
-        if version_str == "3.13":
+        if version_str in ("3", "3.13"):
             return cls.PY_3_13
+        if version_str == "3.14":
+            return cls.PY_3_14
 
         raise ValueError(f"Unsupported Python version: {version_str}")
 
@@ -67,7 +67,7 @@ class PythonVersion(str, Enum):
     @classmethod
     def all(cls) -> list["PythonVersion"]:
         """Returns a list of all supported Python versions."""
-        return [cls.PY_3_9, cls.PY_3_13]
+        return [cls.PY_3_13, cls.PY_3_14]
 
     @classmethod
     def all_csv(cls) -> str:

soar_sdk/decorators/action.py

@@ -1,7 +1,8 @@
 import inspect
 from functools import wraps
 from collections.abc import Iterator
-from typing import Callable, Optional, Any, Union, get_args, get_origin
+from typing import Any, get_args, get_origin
+from collections.abc import Callable
 from collections.abc import AsyncGenerator
 
 from soar_sdk.abstract import SOARClient
@@ -25,24 +26,22 @@ class ActionDecorator:
     def __init__(
         self,
         app: "App",
-        name: Optional[str] = None,
-        identifier: Optional[str] = None,
-        description: Optional[str] = None,
+        name: str | None = None,
+        identifier: str | None = None,
+        description: str | None = None,
         verbose: str = "",
         action_type: str = "generic",
         read_only: bool = True,
-        params_class: Optional[type[Params]] = None,
-        output_class: Union[
-            None,
-            type[ActionOutput],
-            Iterator[type[ActionOutput]],
-            AsyncGenerator[type[ActionOutput]],
-            list[type[ActionOutput]],
-        ] = None,
-        render_as: Optional[str] = None,
-        view_handler: Optional[Callable] = None,
+        params_class: type[Params] | None = None,
+        output_class: None
+        | type[ActionOutput]
+        | Iterator[type[ActionOutput]]
+        | AsyncGenerator[type[ActionOutput]]
+        | list[type[ActionOutput]] = None,
+        render_as: str | None = None,
+        view_handler: Callable | None = None,
         versions: str = "EQ(*)",
-        summary_type: Optional[type[ActionOutput]] = None,
+        summary_type: type[ActionOutput] | None = None,
         enable_concurrency_lock: bool = False,
     ) -> None:
         self.app = app

soar_sdk/decorators/make_request.py

@@ -12,7 +12,8 @@ from soar_sdk.logging import getLogger
 from functools import wraps
 import traceback
 
-from typing import TYPE_CHECKING, Callable, Any, Optional
+from typing import TYPE_CHECKING, Any
+from collections.abc import Callable
 
 if TYPE_CHECKING:
     from soar_sdk.app import App
@@ -24,7 +25,7 @@ class MakeRequestDecorator:
     def __init__(
         self,
         app: "App",
-        output_class: Optional[type[ActionOutput]] = None,
+        output_class: type[ActionOutput] | None = None,
     ) -> None:
         self.app = app
         self.output_class = output_class
@@ -97,7 +98,7 @@ class MakeRequestDecorator:
             **kwargs: Any,  # noqa: ANN401
         ) -> bool:
             try:
-                action_params = validated_params_class.parse_obj(params)
+                action_params = validated_params_class.model_validate(params)
             except Exception as e:
                 logger.info(f"Parameter validation error: {e!s}")
                 return self.app._adapt_action_result(

soar_sdk/decorators/on_poll.py

@@ -1,6 +1,7 @@
 import inspect
 from functools import wraps
-from typing import Callable, Any
+from typing import Any
+from collections.abc import Callable
 from collections.abc import Iterator
 
 from soar_sdk.abstract import SOARClient
@@ -80,7 +81,7 @@ class OnPollDecorator:
             try:
                 # Validate poll params
                 try:
-                    action_params = validated_params_class.parse_obj(params)
+                    action_params = validated_params_class.model_validate(params)
                 except Exception as e:
                     logger.info(f"Parameter validation error: {e!s}")
                     return self.app._adapt_action_result(
@@ -177,8 +178,8 @@ class OnPollDecorator:
 
         # Custom ActionMeta class for on_poll (has no output)
         class OnPollActionMeta(ActionMeta):
-            def dict(self, *args: object, **kwargs: object) -> dict[str, Any]:
-                data = super().dict(*args, **kwargs)
+            def model_dump(self, *args: object, **kwargs: object) -> dict[str, Any]:
+                data = super().model_dump(*args, **kwargs)
                 # Poll actions have no output
                 data["output"] = []
                 return data

soar_sdk/decorators/test_connectivity.py

@@ -1,6 +1,6 @@
 import inspect
 from functools import wraps
-from typing import Callable, Optional
+from collections.abc import Callable
 
 from soar_sdk.abstract import SOARClient
 from soar_sdk.action_results import ActionResult
@@ -48,7 +48,7 @@ class ConnectivityTestDecorator:
         @action_protocol
         @wraps(function)
         def inner(
-            _param: Optional[dict] = None,
+            _param: dict | None = None,
             soar: SOARClient = self.app.soar_client,
         ) -> bool:
             kwargs = self.app._build_magic_args(function, soar=soar)