Merge branch 'main' into NEXUS-703/remove-nestio-loop

Author: awalker4

.genignore

@@ -8,13 +8,10 @@ _test_unstructured_client
 # ignore Makefile
 Makefile
 
-# Ignore the base resource classes while we're patching in our own server url logic
-# If we add a new endpoint, we need to:
-#  - Comment out the ignore for the right file
+# Ignore general.py so we can patch in our partitioning url
+# If we ever have a new endpoint under /general, we need to:
+#  - Comment out this ignore line
 #  - Generate locally, watch the new endpoint appear
+#  - Adjust the custom url snippets in the file
 #  - Bring back the ignore line and commit
-src/unstructured_client/destinations.py
 src/unstructured_client/general.py
-src/unstructured_client/jobs.py
-src/unstructured_client/sources.py
-src/unstructured_client/workflows.py

.github/ISSUE_TEMPLATE/bug_report.md

@@ -19,9 +19,5 @@ A clear and concise description of what you expected to happen.
 **Screenshots**
 If applicable, add screenshots to help explain your problem.
 
-**Environment Info**
-Please run `python scripts/collect_env.py` and paste the output here. 
-This will help us understand more about the environment in which the bug occurred.
-
 **Additional context**
 Add any other context about the problem here.

.speakeasy/gen.lock

@@ -1,12 +1,12 @@
 lockVersion: 2.0.0
 id: 8b5fa338-9106-4734-abf0-e30d67044a90
 management:
-  docChecksum: 3e52fdac3e417f8e48fcb920b829025c
-  docVersion: 1.1.34
-  speakeasyVersion: 1.552.0
-  generationVersion: 2.610.0
-  releaseVersion: 0.39.1
-  configChecksum: 2b0094ee827eb2deb71ef0ff9e572192
+  docChecksum: ae9cd2cec2edbde7b002c0a127c7aa84
+  docVersion: 1.1.42
+  speakeasyVersion: 1.589.0
+  generationVersion: 2.664.0
+  releaseVersion: 0.41.0
+  configChecksum: b2d39b13446f595978a73e31a796dbe7
   repoURL: https://github.com/Unstructured-IO/unstructured-python-client.git
   repoSubDirectory: .
   installationURL: https://github.com/Unstructured-IO/unstructured-python-client.git
@@ -16,30 +16,28 @@ features:
     acceptHeaders: 3.0.0
     additionalDependencies: 1.0.0
     constsAndDefaults: 1.0.5
-    core: 5.19.0
+    core: 5.19.4
     customCodeRegions: 0.1.1
     defaultEnabledRetries: 0.2.0
     enumUnions: 0.1.0
     envVarSecurityUsage: 0.3.2
-    examples: 3.0.1
+    examples: 3.0.2
     globalSecurity: 3.0.3
     globalSecurityCallbacks: 1.0.0
     globalSecurityFlattening: 1.0.0
     globalServerURLs: 3.1.1
-    methodServerURLs: 3.1.1
     multipartFileContentType: 1.0.0
     nameOverrides: 3.0.1
     nullables: 1.0.1
     openEnums: 1.0.1
     responseFormat: 1.0.1
     retries: 3.0.2
-    sdkHooks: 1.0.1
+    sdkHooks: 1.1.0
     serverIDs: 3.0.0
     unions: 3.0.4
     uploadStreams: 1.0.0
 generatedFiles:
   - .gitattributes
-  - .python-version
   - .vscode/settings.json
   - USAGE.md
   - docs/models/errors/detail.md
@@ -71,6 +69,8 @@ generatedFiles:
   - docs/models/operations/getconnectionchecksourcesresponse.md
   - docs/models/operations/getdestinationrequest.md
   - docs/models/operations/getdestinationresponse.md
+  - docs/models/operations/getencryptioncertificaterequest.md
+  - docs/models/operations/getencryptioncertificateresponse.md
   - docs/models/operations/getjobdetailsrequest.md
   - docs/models/operations/getjobdetailsresponse.md
   - docs/models/operations/getjobfailedfilesrequest.md
@@ -91,8 +91,6 @@ generatedFiles:
   - docs/models/operations/listworkflowsresponse.md
   - docs/models/operations/partitionrequest.md
   - docs/models/operations/partitionresponse.md
-  - docs/models/operations/retrieverequest.md
-  - docs/models/operations/retrieveresponse.md
   - docs/models/operations/runworkflowrequest.md
   - docs/models/operations/runworkflowresponse.md
   - docs/models/operations/storesecretrequest.md
@@ -140,6 +138,7 @@ generatedFiles:
   - docs/models/shared/elasticsearchconnectorconfig.md
   - docs/models/shared/elasticsearchconnectorconfiginput.md
   - docs/models/shared/encryptedsecret.md
+  - docs/models/shared/encryptioncertificateresponse.md
   - docs/models/shared/encryptiontype.md
   - docs/models/shared/failedfile.md
   - docs/models/shared/files.md
@@ -181,7 +180,6 @@ generatedFiles:
   - docs/models/shared/outlooksourceconnectorconfiginput.md
   - docs/models/shared/outputformat.md
   - docs/models/shared/partitionparameters.md
-  - docs/models/shared/pemauthresponse.md
   - docs/models/shared/pineconedestinationconnectorconfig.md
   - docs/models/shared/pineconedestinationconnectorconfiginput.md
   - docs/models/shared/postgresdestinationconnectorconfig.md
@@ -252,12 +250,17 @@ generatedFiles:
   - src/unstructured_client/_hooks/types.py
   - src/unstructured_client/_version.py
   - src/unstructured_client/basesdk.py
+  - src/unstructured_client/destinations.py
   - src/unstructured_client/httpclient.py
+  - src/unstructured_client/jobs.py
   - src/unstructured_client/models/__init__.py
   - src/unstructured_client/models/errors/__init__.py
   - src/unstructured_client/models/errors/httpvalidationerror.py
+  - src/unstructured_client/models/errors/no_response_error.py
+  - src/unstructured_client/models/errors/responsevalidationerror.py
   - src/unstructured_client/models/errors/sdkerror.py
   - src/unstructured_client/models/errors/servererror.py
+  - src/unstructured_client/models/errors/unstructuredclienterror.py
   - src/unstructured_client/models/operations/__init__.py
   - src/unstructured_client/models/operations/cancel_job.py
   - src/unstructured_client/models/operations/create_connection_check_destinations.py
@@ -272,6 +275,7 @@ generatedFiles:
   - src/unstructured_client/models/operations/get_connection_check_destinations.py
   - src/unstructured_client/models/operations/get_connection_check_sources.py
   - src/unstructured_client/models/operations/get_destination.py
+  - src/unstructured_client/models/operations/get_encryption_certificate.py
   - src/unstructured_client/models/operations/get_job.py
   - src/unstructured_client/models/operations/get_job_details.py
   - src/unstructured_client/models/operations/get_job_failed_files.py
@@ -282,7 +286,6 @@ generatedFiles:
   - src/unstructured_client/models/operations/list_sources.py
   - src/unstructured_client/models/operations/list_workflows.py
   - src/unstructured_client/models/operations/partition.py
-  - src/unstructured_client/models/operations/retrieve.py
   - src/unstructured_client/models/operations/run_workflow.py
   - src/unstructured_client/models/operations/store_secret.py
   - src/unstructured_client/models/operations/update_destination.py
@@ -323,6 +326,7 @@ generatedFiles:
   - src/unstructured_client/models/shared/elasticsearchconnectorconfig.py
   - src/unstructured_client/models/shared/elasticsearchconnectorconfiginput.py
   - src/unstructured_client/models/shared/encryptedsecret.py
+  - src/unstructured_client/models/shared/encryptioncertificateresponse.py
   - src/unstructured_client/models/shared/encryptiontype.py
   - src/unstructured_client/models/shared/failedfile.py
   - src/unstructured_client/models/shared/gcsdestinationconnectorconfig.py
@@ -359,7 +363,6 @@ generatedFiles:
   - src/unstructured_client/models/shared/outlooksourceconnectorconfig.py
   - src/unstructured_client/models/shared/outlooksourceconnectorconfiginput.py
   - src/unstructured_client/models/shared/partition_parameters.py
-  - src/unstructured_client/models/shared/pemauthresponse.py
   - src/unstructured_client/models/shared/pineconedestinationconnectorconfig.py
   - src/unstructured_client/models/shared/pineconedestinationconnectorconfiginput.py
   - src/unstructured_client/models/shared/postgresdestinationconnectorconfig.py
@@ -404,6 +407,7 @@ generatedFiles:
   - src/unstructured_client/py.typed
   - src/unstructured_client/sdk.py
   - src/unstructured_client/sdkconfiguration.py
+  - src/unstructured_client/sources.py
   - src/unstructured_client/types/__init__.py
   - src/unstructured_client/types/basemodel.py
   - src/unstructured_client/users.py
@@ -421,8 +425,10 @@ generatedFiles:
   - src/unstructured_client/utils/retries.py
   - src/unstructured_client/utils/security.py
   - src/unstructured_client/utils/serializers.py
+  - src/unstructured_client/utils/unmarshal_json_response.py
   - src/unstructured_client/utils/url.py
   - src/unstructured_client/utils/values.py
+  - src/unstructured_client/workflows.py
 examples:
   create_connection_check_destinations:
     speakeasy-default-create-connection-check-destinations:
@@ -709,5 +715,12 @@ examples:
           application/json: {"id": "<id>"}
         "422":
           application/json: {"detail": []}
+  get_encryption_certificate:
+    speakeasy-default-get-encryption-certificate:
+      responses:
+        "200":
+          application/json: {"ca_chain": "<value>", "encryption_certificate": "<value>"}
+        "422":
+          application/json: {"detail": []}
 examplesVersion: 1.0.2
 generatedTests: {}

.speakeasy/workflow.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.552.0
+speakeasyVersion: 1.589.0
 sources:
     my-source:
         sourceNamespace: my-source
-        sourceRevisionDigest: sha256:ac2955e4a812caa63ad339156504c9bdfae02dd241800a6c48892aaf37552c54
-        sourceBlobDigest: sha256:eb516ced31caa9801a7996b8216fa7c7a46ab16dc9edd4d9eef5721cee7acd6c
+        sourceRevisionDigest: sha256:dc1c7c974419187404b25cb443e0d2497aa8b3ab71c95f27054eb5cd87b02ed0
+        sourceBlobDigest: sha256:538ee1e259eb1db25ba57b09ba271636bad0015a794517bf6f910315e7ecaac3
         tags:
             - latest
-            - speakeasy-sdk-regen-1752365566
-            - 1.1.34
+            - speakeasy-sdk-regen-1753403247
+            - 1.1.42
 targets:
     unstructured-python:
         source: my-source
         sourceNamespace: my-source
-        sourceRevisionDigest: sha256:ac2955e4a812caa63ad339156504c9bdfae02dd241800a6c48892aaf37552c54
-        sourceBlobDigest: sha256:eb516ced31caa9801a7996b8216fa7c7a46ab16dc9edd4d9eef5721cee7acd6c
+        sourceRevisionDigest: sha256:dc1c7c974419187404b25cb443e0d2497aa8b3ab71c95f27054eb5cd87b02ed0
+        sourceBlobDigest: sha256:538ee1e259eb1db25ba57b09ba271636bad0015a794517bf6f910315e7ecaac3
         codeSamplesNamespace: my-source-code-samples
-        codeSamplesRevisionDigest: sha256:e644b82aab2fb0dc0c506d643aa22910ae14bc998f2b13ac7cc019a789dbe552
+        codeSamplesRevisionDigest: sha256:1e8db4a01c54f1f99e27cc80d3f5283192aa2a6a68001f80424fbf9bdface495
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.41.0
+
+### Enhancements
+
+### Features
+* Provide a base `UnstructuredClientError` to capture every error raised by the SDK. Note that some exceptions such as `SDKError` now have more information in the `message` field. This will impact any users who rely on string matching in their error handling.
+
+### Fixes
+
 ## 0.37.3
 
 ### Enhancements

README.md

@@ -153,26 +153,18 @@ with UnstructuredClient(
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.
+[`UnstructuredClientError`](./src/unstructured_client/models/errors/unstructuredclienterror.py) is the base class for all HTTP error responses. It has the following properties:
 
-By default, an API error will raise a errors.SDKError exception, which has the following properties:
-
-| Property        | Type             | Description           |
-|-----------------|------------------|-----------------------|
-| `.status_code`  | *int*            | The HTTP status code  |
-| `.message`      | *str*            | The error message     |
-| `.raw_response` | *httpx.Response* | The raw HTTP response |
-| `.body`         | *str*            | The response content  |
-
-When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `create_connection_check_destinations_async` method may raise the following exceptions:
-
-| Error Type                 | Status Code | Content Type     |
-| -------------------------- | ----------- | ---------------- |
-| errors.HTTPValidationError | 422         | application/json |
-| errors.SDKError            | 4XX, 5XX    | \*/\*            |
+| Property           | Type             | Description                                                                             |
+| ------------------ | ---------------- | --------------------------------------------------------------------------------------- |
+| `err.message`      | `str`            | Error message                                                                           |
+| `err.status_code`  | `int`            | HTTP response status code eg `404`                                                      |
+| `err.headers`      | `httpx.Headers`  | HTTP response headers                                                                   |
+| `err.body`         | `str`            | HTTP body. Can be empty string if no body is returned.                                  |
+| `err.raw_response` | `httpx.Response` | Raw HTTP response                                                                       |
+| `err.data`         |                  | Optional. Some errors may contain structured data. [See Error Classes](#error-classes). |
 
 ### Example
-
 ```python
 from unstructured_client import UnstructuredClient
 from unstructured_client.models import errors
@@ -191,13 +183,42 @@ with UnstructuredClient() as uc_client:
         # Handle response
         print(res.dag_node_connection_check)
 
-    except errors.HTTPValidationError as e:
-        # handle e.data: errors.HTTPValidationErrorData
-        raise(e)
-    except errors.SDKError as e:
-        # handle exception
-        raise(e)
+
+    except errors.UnstructuredClientError as e:
+        # The base class for HTTP error responses
+        print(e.message)
+        print(e.status_code)
+        print(e.body)
+        print(e.headers)
+        print(e.raw_response)
+
+        # Depending on the method different errors may be thrown
+        if isinstance(e, errors.HTTPValidationError):
+            print(e.data.detail)  # Optional[errors.Detail]
 ```
+
+### Error Classes
+**Primary errors:**
+* [`UnstructuredClientError`](./src/unstructured_client/models/errors/unstructuredclienterror.py): The base class for HTTP error responses.
+  * [`HTTPValidationError`](./src/unstructured_client/models/errors/httpvalidationerror.py): Validation Error. Status code `422`.
+
+<details><summary>Less common errors (6)</summary>
+
+<br />
+
+**Network errors:**
+* [`httpx.RequestError`](https://www.python-httpx.org/exceptions/#httpx.RequestError): Base class for request errors.
+    * [`httpx.ConnectError`](https://www.python-httpx.org/exceptions/#httpx.ConnectError): HTTP client was unable to make a request to a server.
+    * [`httpx.TimeoutException`](https://www.python-httpx.org/exceptions/#httpx.TimeoutException): HTTP request timed out.
+
+
+**Inherit from [`UnstructuredClientError`](./src/unstructured_client/models/errors/unstructuredclienterror.py)**:
+* [`ServerError`](./src/unstructured_client/models/errors/servererror.py): Server Error. Status code `5XX`. Applicable to 1 of 29 methods.*
+* [`ResponseValidationError`](./src/unstructured_client/models/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
+
+</details>
+
+\* Check [the method documentation](#available-resources-and-operations) to see if the error is applicable.
 <!-- End Error Handling [errors] -->
 
 <!-- Start Custom HTTP Client [http-client] -->
@@ -316,7 +337,7 @@ with UnstructuredClient() as uc_client:
 
 </br>
 
-The same SDK client can also be used to make asynchronous requests by importing asyncio.
+The same SDK client can also be used to make asychronous requests by importing asyncio.
 ```python
 # Asynchronous Example
 import asyncio
@@ -410,30 +431,18 @@ Certain SDK methods accept file objects as part of a request body or multi-part
 
 ```python
 from unstructured_client import UnstructuredClient
-from unstructured_client.models import shared
 
 
 with UnstructuredClient() as uc_client:
 
-    res = uc_client.general.partition(request={
-        "partition_parameters": {
-            "files": {
-                "content": open("example.file", "rb"),
-                "file_name": "example.file",
-            },
-            "split_pdf_page_range": [
-                1,
-                10,
-            ],
-            "vlm_model": shared.VLMModel.GPT_4O,
-            "vlm_model_provider": shared.VLMModelProvider.OPENAI,
-        },
+    res = uc_client.workflows.run_workflow(request={
+        "workflow_id": "e7054f23-ce92-4bf1-a1d7-7cf9cb14d013",
     })
 
-    assert res.elements is not None
+    assert res.job_information is not None
 
     # Handle response
-    print(res.elements)
+    print(res.job_information)
 
 ```
 <!-- End File uploads [file-upload] -->

RELEASES.md

@@ -1058,4 +1058,25 @@ Based on:
 ### Generated
 - [python v0.39.1] .
 ### Releases
-- [PyPI v0.39.1] https://pypi.org/project/unstructured-client/0.39.1 - .
+- [PyPI v0.39.1] https://pypi.org/project/unstructured-client/0.39.1 - .
+
+## 2025-07-23 19:20:27
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.552.0 (2.610.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.40.0] .
+### Releases
+- [PyPI v0.40.0] https://pypi.org/project/unstructured-client/0.40.0 - .
+
+
+## 2025-07-25 00:27:12
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.589.0 (2.664.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.41.0] .
+### Releases
+- [PyPI v0.41.0] https://pypi.org/project/unstructured-client/0.41.0 - .