Merge pull request #220 from RevEngAI/sdk-update-v4.67.1

🤖 Update SDK to version v4.67.1

Author: robertmarsal

.sdk-version

@@ -1 +1 @@
-v4.64.0
+v4.67.1

README.md

@@ -562,6 +562,7 @@ Class | Method | HTTP request | Description
  - [Display](docs/Display.md)
  - [DnsQuery](docs/DnsQuery.md)
  - [DrakvufFileMetadata](docs/DrakvufFileMetadata.md)
+ - [DynamicExecutionMetadata](docs/DynamicExecutionMetadata.md)
  - [DynamicExecutionStatus](docs/DynamicExecutionStatus.md)
  - [DynamicExecutionStatusResponse](docs/DynamicExecutionStatusResponse.md)
  - [ELFImportModel](docs/ELFImportModel.md)
@@ -769,10 +770,12 @@ Class | Method | HTTP request | Description
  - [NetworkingScanResult](docs/NetworkingScanResult.md)
  - [NetworkingVerification](docs/NetworkingVerification.md)
  - [OIDCCallbackInputBody](docs/OIDCCallbackInputBody.md)
+ - [OperandXref](docs/OperandXref.md)
  - [OperationBinaryExportMetadataBinaryExportResult](docs/OperationBinaryExportMetadataBinaryExportResult.md)
  - [OperationCreateMetadataCreateResult](docs/OperationCreateMetadataCreateResult.md)
  - [OperationCryptoExplainMetadataCryptoExplainResult](docs/OperationCryptoExplainMetadataCryptoExplainResult.md)
  - [OperationCryptoScanMetadataCryptoScanResult](docs/OperationCryptoScanMetadataCryptoScanResult.md)
+ - [OperationDynamicExecutionMetadataDynamicExecutionResult](docs/OperationDynamicExecutionMetadataDynamicExecutionResult.md)
  - [OperationExecutionExplainMetadataExecutionExplainResult](docs/OperationExecutionExplainMetadataExecutionExplainResult.md)
  - [OperationExecutionScanMetadataExecutionScanResult](docs/OperationExecutionScanMetadataExecutionScanResult.md)
  - [OperationFilesystemAnalyseMetadataFilesystemAnalyseResult](docs/OperationFilesystemAnalyseMetadataFilesystemAnalyseResult.md)
@@ -854,6 +857,7 @@ Class | Method | HTTP request | Description
  - [ResultBody](docs/ResultBody.md)
  - [RevokeBody](docs/RevokeBody.md)
  - [RuleKind](docs/RuleKind.md)
+ - [RunDynamicExecutionInputBody](docs/RunDynamicExecutionInputBody.md)
  - [SSOProvider](docs/SSOProvider.md)
  - [SSOProvidersOutputBody](docs/SSOProvidersOutputBody.md)
  - [SandboxConfig](docs/SandboxConfig.md)

docs/DisassemblyOutputBody.md

@@ -9,6 +9,7 @@ Name | Type | Description | Notes
 **function_id** | **int** |  | 
 **global_variables** | **object** |  | [optional] 
 **local_variables** | **object** |  | [optional] 
+**operand_xrefs** | [**List[OperandXref]**](OperandXref.md) | Instruction operands that reference a pointer slot, sorted by instruction_vaddr, target_vaddr, pointed_vaddr. | [optional] 
 **params** | **object** |  | [optional] 
 **return_type** | **str** |  | [optional] 
 **returns** | **bool** |  | 

docs/DynamicExecutionMetadata.md

@@ -0,0 +1,30 @@
+# DynamicExecutionMetadata
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**logs** | [**AnalysisLogs**](AnalysisLogs.md) | Sandbox status log messages captured during the run. Empty when none have been captured yet. | 
+**status** | **str** | Run status. UNINITIALISED means this analysis has never had a run triggered. | 
+
+## Example
+
+```python
+from revengai.models.dynamic_execution_metadata import DynamicExecutionMetadata
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of DynamicExecutionMetadata from a JSON string
+dynamic_execution_metadata_instance = DynamicExecutionMetadata.from_json(json)
+# print the JSON string representation of the object
+print(DynamicExecutionMetadata.to_json())
+
+# convert the object into a dict
+dynamic_execution_metadata_dict = dynamic_execution_metadata_instance.to_dict()
+# create an instance of DynamicExecutionMetadata from a dict
+dynamic_execution_metadata_from_dict = DynamicExecutionMetadata.from_dict(dynamic_execution_metadata_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/OperandXref.md

@@ -0,0 +1,31 @@
+# OperandXref
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**instruction_vaddr** | **int** | Vaddr of the instruction containing the operand. | 
+**pointed_vaddr** | **int** | Address stored in the pointer slot. Resolve this to a function, import or global to name the reference. | 
+**target_vaddr** | **int** | Vaddr of the pointer slot the operand references. | 
+
+## Example
+
+```python
+from revengai.models.operand_xref import OperandXref
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of OperandXref from a JSON string
+operand_xref_instance = OperandXref.from_json(json)
+# print the JSON string representation of the object
+print(OperandXref.to_json())
+
+# convert the object into a dict
+operand_xref_dict = operand_xref_instance.to_dict()
+# create an instance of OperandXref from a dict
+operand_xref_from_dict = OperandXref.from_dict(operand_xref_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/OperationDynamicExecutionMetadataDynamicExecutionResult.md

@@ -0,0 +1,33 @@
+# OperationDynamicExecutionMetadataDynamicExecutionResult
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**done** | **bool** | Whether the operation has reached a terminal state. | 
+**error** | [**Status**](Status.md) | Failure detail, populated only when done is true and the operation failed. | [optional] 
+**metadata** | [**DynamicExecutionMetadata**](DynamicExecutionMetadata.md) | In-flight information and details. | [optional] 
+**name** | **str** | API resource name. | 
+**response** | **object** |  | [optional] 
+
+## Example
+
+```python
+from revengai.models.operation_dynamic_execution_metadata_dynamic_execution_result import OperationDynamicExecutionMetadataDynamicExecutionResult
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of OperationDynamicExecutionMetadataDynamicExecutionResult from a JSON string
+operation_dynamic_execution_metadata_dynamic_execution_result_instance = OperationDynamicExecutionMetadataDynamicExecutionResult.from_json(json)
+# print the JSON string representation of the object
+print(OperationDynamicExecutionMetadataDynamicExecutionResult.to_json())
+
+# convert the object into a dict
+operation_dynamic_execution_metadata_dynamic_execution_result_dict = operation_dynamic_execution_metadata_dynamic_execution_result_instance.to_dict()
+# create an instance of OperationDynamicExecutionMetadataDynamicExecutionResult from a dict
+operation_dynamic_execution_metadata_dynamic_execution_result_from_dict = OperationDynamicExecutionMetadataDynamicExecutionResult.from_dict(operation_dynamic_execution_metadata_dynamic_execution_result_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/RunDynamicExecutionInputBody.md

@@ -0,0 +1,34 @@
+# RunDynamicExecutionInputBody
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**archive_entry_path** | **str** | Relative path of the entry inside the archive to execute | [optional] 
+**archive_password** | **str** | Password for an encrypted archive | [optional] 
+**archive_sha_256_hash** | **str** | SHA-256 of the archive object to send to the sandbox instead of the analysed binary | [optional] 
+**command_line_args** | **str** | Command-line arguments passed to the sample when the sandbox launches it | [optional] 
+**start_method** | **str** | How the sandbox launches the sample. Defaults to the sandbox's standard behaviour when omitted. | [optional] 
+**timeout** | **int** | Maximum sandbox execution time in seconds | [optional] [default to 120]
+
+## Example
+
+```python
+from revengai.models.run_dynamic_execution_input_body import RunDynamicExecutionInputBody
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of RunDynamicExecutionInputBody from a JSON string
+run_dynamic_execution_input_body_instance = RunDynamicExecutionInputBody.from_json(json)
+# print the JSON string representation of the object
+print(RunDynamicExecutionInputBody.to_json())
+
+# convert the object into a dict
+run_dynamic_execution_input_body_dict = run_dynamic_execution_input_body_instance.to_dict()
+# create an instance of RunDynamicExecutionInputBody from a dict
+run_dynamic_execution_input_body_from_dict = RunDynamicExecutionInputBody.from_dict(run_dynamic_execution_input_body_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

revengai/__init__.py

@@ -13,7 +13,7 @@
 """  # noqa: E501
 
 
-__version__ = "v4.64.0"
+__version__ = "v4.67.1"
 
 # Define package exports
 __all__ = [
@@ -321,6 +321,7 @@
     "Display",
     "DnsQuery",
     "DrakvufFileMetadata",
+    "DynamicExecutionMetadata",
     "DynamicExecutionStatus",
     "DynamicExecutionStatusResponse",
     "ELFImportModel",
@@ -528,10 +529,12 @@
     "NetworkingScanResult",
     "NetworkingVerification",
     "OIDCCallbackInputBody",
+    "OperandXref",
     "OperationBinaryExportMetadataBinaryExportResult",
     "OperationCreateMetadataCreateResult",
     "OperationCryptoExplainMetadataCryptoExplainResult",
     "OperationCryptoScanMetadataCryptoScanResult",
+    "OperationDynamicExecutionMetadataDynamicExecutionResult",
     "OperationExecutionExplainMetadataExecutionExplainResult",
     "OperationExecutionScanMetadataExecutionScanResult",
     "OperationFilesystemAnalyseMetadataFilesystemAnalyseResult",
@@ -613,6 +616,7 @@
     "ResultBody",
     "RevokeBody",
     "RuleKind",
+    "RunDynamicExecutionInputBody",
     "SSOProvider",
     "SSOProvidersOutputBody",
     "SandboxConfig",
@@ -1098,6 +1102,7 @@
 from revengai.models.display import Display as Display
 from revengai.models.dns_query import DnsQuery as DnsQuery
 from revengai.models.drakvuf_file_metadata import DrakvufFileMetadata as DrakvufFileMetadata
+from revengai.models.dynamic_execution_metadata import DynamicExecutionMetadata as DynamicExecutionMetadata
 from revengai.models.dynamic_execution_status import DynamicExecutionStatus as DynamicExecutionStatus
 from revengai.models.dynamic_execution_status_response import DynamicExecutionStatusResponse as DynamicExecutionStatusResponse
 from revengai.models.elf_import_model import ELFImportModel as ELFImportModel
@@ -1305,10 +1310,12 @@
 from revengai.models.networking_scan_result import NetworkingScanResult as NetworkingScanResult
 from revengai.models.networking_verification import NetworkingVerification as NetworkingVerification
 from revengai.models.oidc_callback_input_body import OIDCCallbackInputBody as OIDCCallbackInputBody
+from revengai.models.operand_xref import OperandXref as OperandXref
 from revengai.models.operation_binary_export_metadata_binary_export_result import OperationBinaryExportMetadataBinaryExportResult as OperationBinaryExportMetadataBinaryExportResult
 from revengai.models.operation_create_metadata_create_result import OperationCreateMetadataCreateResult as OperationCreateMetadataCreateResult
 from revengai.models.operation_crypto_explain_metadata_crypto_explain_result import OperationCryptoExplainMetadataCryptoExplainResult as OperationCryptoExplainMetadataCryptoExplainResult
 from revengai.models.operation_crypto_scan_metadata_crypto_scan_result import OperationCryptoScanMetadataCryptoScanResult as OperationCryptoScanMetadataCryptoScanResult
+from revengai.models.operation_dynamic_execution_metadata_dynamic_execution_result import OperationDynamicExecutionMetadataDynamicExecutionResult as OperationDynamicExecutionMetadataDynamicExecutionResult
 from revengai.models.operation_execution_explain_metadata_execution_explain_result import OperationExecutionExplainMetadataExecutionExplainResult as OperationExecutionExplainMetadataExecutionExplainResult
 from revengai.models.operation_execution_scan_metadata_execution_scan_result import OperationExecutionScanMetadataExecutionScanResult as OperationExecutionScanMetadataExecutionScanResult
 from revengai.models.operation_filesystem_analyse_metadata_filesystem_analyse_result import OperationFilesystemAnalyseMetadataFilesystemAnalyseResult as OperationFilesystemAnalyseMetadataFilesystemAnalyseResult
@@ -1390,6 +1397,7 @@
 from revengai.models.result_body import ResultBody as ResultBody
 from revengai.models.revoke_body import RevokeBody as RevokeBody
 from revengai.models.rule_kind import RuleKind as RuleKind
+from revengai.models.run_dynamic_execution_input_body import RunDynamicExecutionInputBody as RunDynamicExecutionInputBody
 from revengai.models.sso_provider import SSOProvider as SSOProvider
 from revengai.models.sso_providers_output_body import SSOProvidersOutputBody as SSOProvidersOutputBody
 from revengai.models.sandbox_config import SandboxConfig as SandboxConfig

revengai/api/analyses_bulk_actions_api.py

@@ -58,7 +58,7 @@ def bulk_add_analysis_tags(
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> BaseResponseAnalysisBulkAddTagsResponse:
-        """Bulk Add Analysis Tags
+        """(Deprecated) Bulk Add Analysis Tags
 
         Updates analysis tags for multiple analyses. User must be the owner.
 
@@ -85,6 +85,7 @@ def bulk_add_analysis_tags(
         :type _host_index: int, optional
         :return: Returns the result object.
         """ # noqa: E501
+        warnings.warn("PATCH /v2/analyses/tags/add is deprecated.", DeprecationWarning)
 
         _param = self._bulk_add_analysis_tags_serialize(
             analysis_bulk_add_tags_request=analysis_bulk_add_tags_request,
@@ -126,7 +127,7 @@ def bulk_add_analysis_tags_with_http_info(
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[BaseResponseAnalysisBulkAddTagsResponse]:
-        """Bulk Add Analysis Tags
+        """(Deprecated) Bulk Add Analysis Tags
 
         Updates analysis tags for multiple analyses. User must be the owner.
 
@@ -153,6 +154,7 @@ def bulk_add_analysis_tags_with_http_info(
         :type _host_index: int, optional
         :return: Returns the result object.
         """ # noqa: E501
+        warnings.warn("PATCH /v2/analyses/tags/add is deprecated.", DeprecationWarning)
 
         _param = self._bulk_add_analysis_tags_serialize(
             analysis_bulk_add_tags_request=analysis_bulk_add_tags_request,
@@ -194,7 +196,7 @@ def bulk_add_analysis_tags_without_preload_content(
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Bulk Add Analysis Tags
+        """(Deprecated) Bulk Add Analysis Tags
 
         Updates analysis tags for multiple analyses. User must be the owner.
 
@@ -221,6 +223,7 @@ def bulk_add_analysis_tags_without_preload_content(
         :type _host_index: int, optional
         :return: Returns the result object.
         """ # noqa: E501
+        warnings.warn("PATCH /v2/analyses/tags/add is deprecated.", DeprecationWarning)
 
         _param = self._bulk_add_analysis_tags_serialize(
             analysis_bulk_add_tags_request=analysis_bulk_add_tags_request,