Merge pull request #143 from criblio/speakeasy-sdk-regen-dev-1760576200

chore: 🐝 Update SDK - Generate Dev SDK [dev] 0.2.0b5

Author: michalbiesek

.speakeasy/gen.lock

@@ -1,12 +1,12 @@
 lockVersion: 2.0.0
 id: cfa345be-20bc-4980-a260-c3fa74040ac2
 management:
-  docChecksum: 55f2c1b59f274948fdc572a79f59dcc1
-  docVersion: 4.15.0-alpha.1760486888592-e1e43793
+  docChecksum: a36d607d60e776a4c9cc735310b933ee
+  docVersion: 4.15.0-alpha.1760569726872-c3466a59
   speakeasyVersion: 1.636.3
   generationVersion: 2.723.11
-  releaseVersion: 0.2.0b4
-  configChecksum: b9fb8ecfb9fb27290e16ba66e6b34eff
+  releaseVersion: 0.2.0b5
+  configChecksum: 4059da1d9fbd0779c7d1230c34ad4916
   repoURL: https://github.com/criblio/cribl_control_plane_sdk_python.git
   installationURL: https://github.com/criblio/cribl_control_plane_sdk_python.git
   published: true
@@ -35,6 +35,7 @@ features:
     retries: 3.0.2
     sdkHooks: 1.1.0
     unions: 3.1.0
+    uploadStreams: 1.0.0
 generatedFiles:
   - .devcontainer/README.md
   - .devcontainer/devcontainer.json
@@ -1982,10 +1983,12 @@ generatedFiles:
   - docs/models/updateoutputbyidresponse.md
   - docs/models/updatepacksbyidrequest.md
   - docs/models/updatepacksbyidresponse.md
+  - docs/models/updatepacksrequest.md
   - docs/models/updatepipelinebyidrequest.md
   - docs/models/updatepipelinebyidresponse.md
   - docs/models/updateroutesbyidrequest.md
   - docs/models/updateroutesbyidresponse.md
+  - docs/models/uploadpackresponse.md
   - docs/models/useraccesscontrollist.md
   - docs/models/usersandgroups.md
   - docs/models/utils/retryconfig.md
@@ -2308,8 +2311,10 @@ generatedFiles:
   - src/cribl_control_plane/models/updateinputhectokenbyidandtokenop.py
   - src/cribl_control_plane/models/updateoutputbyidop.py
   - src/cribl_control_plane/models/updatepacksbyidop.py
+  - src/cribl_control_plane/models/updatepacksop.py
   - src/cribl_control_plane/models/updatepipelinebyidop.py
   - src/cribl_control_plane/models/updateroutesbyidop.py
+  - src/cribl_control_plane/models/uploadpackresponse.py
   - src/cribl_control_plane/models/useraccesscontrollist.py
   - src/cribl_control_plane/models/workertypes.py
   - src/cribl_control_plane/nodes.py
@@ -2839,9 +2844,11 @@ examples:
       parameters:
         query:
           filename: "example.file"
+      requestBody:
+        application/octet-stream: "x-file: example.file"
       responses:
         "200":
-          application/json: {"count": 779474, "items": [{}, {"key": "<value>"}]}
+          application/json: {"source": "<value>"}
         "500":
           application/json: {"message": "<value>"}
   getGroupsConfigVersionById:
@@ -3277,3 +3284,11 @@ generatedTests:
   updatePacksById: "2025-08-01T02:34:48Z"
   deleteGroupsById: "2025-08-04T02:32:44Z"
   updateGroupsById: "2025-08-04T02:32:44Z"
+releaseNotes: |
+  ## Python SDK Changes Detected:
+  * `cribl_control_plane.packs.upload()`: **Added**
+  * `cribl_control_plane.packs.install()`:  `response.items.[].tags.data_type` **Changed**
+  * `cribl_control_plane.packs.list()`:  `response.items.[].tags.data_type` **Changed**
+  * `cribl_control_plane.packs.delete()`:  `response.items.[].tags.data_type` **Changed**
+  * `cribl_control_plane.packs.get()`:  `response.items.[].tags.data_type` **Changed**
+  * `cribl_control_plane.packs.update()`:  `response.items.[].tags.data_type` **Changed**

.speakeasy/gen.yaml

@@ -26,7 +26,7 @@ generation:
     generateNewTests: false
     skipResponseBodyAssertions: false
 python:
-  version: 0.2.0b4
+  version: 0.2.0b5
   additionalDependencies:
     dev: {}
     main: {}

.speakeasy/out.openapi.yaml

@@ -4,7 +4,7 @@ servers:
 info:
   title: Cribl API Reference
   description: This API Reference lists available REST endpoints, along with their supported operations for accessing, creating, updating, or deleting resources. See our complementary product documentation at [docs.cribl.io](http://docs.cribl.io).
-  version: 4.15.0-alpha.1760486888592-e1e43793
+  version: 4.15.0-alpha.1760569726872-c3466a59
   contact:
     name: Support
     url: https://portal.support.cribl.io
@@ -41088,8 +41088,6 @@ components:
               type: array
               items:
                 type: string
-          required:
-            - dataType
         version:
           type: string
         warnings:
@@ -41198,8 +41196,6 @@ components:
               type: array
               items:
                 type: string
-          required:
-            - dataType
         version:
           type: string
       required:
@@ -41218,6 +41214,13 @@ components:
           type: string
       required:
         - source
+    UploadPackResponse:
+      type: object
+      properties:
+        source:
+          type: string
+      required:
+        - source
     GitCommitSummary:
       type: object
       properties:
@@ -43557,8 +43560,8 @@ paths:
         - packs
       x-speakeasy-group: packs
       x-speakeasy-name-override: install
-      summary: Create or install a Pack
-      description: Create or install a Pack.
+      summary: Install a Pack
+      description: Install a Pack.<br><br>To install an uploaded Pack, provide the <code>source</code> value from the <code>PUT /packs</code> response as the <code>source</code> parameter in the request body.<br><br>To install a Pack by importing from a URL, provide the direct URL location of the <code>.crbl</code> file for the Pack as the <code>source</code> parameter in the request body.<br><br>To install a Pack by importing from a Git repository, provide <code>git+<repo-url></code> as the <code>source</code> parameter in the request body.<br><br>If you do not include the <code>source</code> parameter in the request body, an empty Pack is created.
       responses:
         "200":
           description: a list of PackInstallInfo objects
@@ -43627,6 +43630,44 @@ paths:
           schema:
             type: string
           description: Comma-separated list of additional properties to include in the response. When set, the response includes a count of the specified properties in the Pack. Available values are <code>inputs</code> and <code>outputs</code>.
+    put:
+      operationId: updatePacks
+      tags:
+        - packs
+      x-speakeasy-group: packs
+      x-speakeasy-name-override: upload
+      summary: Upload a Pack file
+      description: Upload a Pack file. Returns the <code>source</code> ID needed to install the Pack with <code>POST /packs</source>, which you must call separately.
+      responses:
+        "200":
+          description: Pack file uploaded successfully
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/UploadPackResponse"
+        "401":
+          description: Unauthorized
+        "500":
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+      requestBody:
+        description: Binary file content
+        required: true
+        content:
+          application/octet-stream:
+            schema:
+              type: string
+              format: binary
+      parameters:
+        - name: filename
+          in: query
+          required: true
+          schema:
+            type: string
+          description: Filename of the Pack file to upload.
   /packs/{id}:
     delete:
       operationId: deletePacksById
@@ -43711,7 +43752,7 @@ paths:
       x-speakeasy-group: packs
       x-speakeasy-name-override: update
       summary: Upgrade a Pack
-      description: Upgrade the specified Pack.</br></br>If the Pack includes any user–modified versions of default Cribl Knowledge resources such as lookups, copy the modified files locally for safekeeping before upgrading the Pack. Copy the modified files back to the upgraded Pack after you install it with <code>POST /packs</code> to overwrite the default versions in the Pack.</br></br>After you upgrade the Pack, update any Routes, Pipelines, Sources, and Destinations that use the previous Pack version so that they reference the upgraded Pack.
+      description: Upgrade the specified Pack.</br></br>If the Pack includes any user–modified versions of default Cribl Knowledge resources such as lookups, copy the modified files locally for safekeeping before upgrading the Pack.Copy the modified files back to the upgraded Pack after you install it with <code>POST /packs</code> to overwrite the default versions in the Pack.</br></br>After you upgrade the Pack, update any Routes, Pipelines, Sources, and Destinations that use the previous Pack version so that they reference the upgraded Pack.
       responses:
         "200":
           description: a list of PackInfo objects

.speakeasy/workflow.lock

@@ -2,20 +2,20 @@ speakeasyVersion: 1.636.3
 sources:
     Cribl API Reference:
         sourceNamespace: cribl-api-reference
-        sourceRevisionDigest: sha256:5b78d074d97a6f3f04525bd9fa58d282fc38230c91b70f45b3d39ae1c69d1a40
-        sourceBlobDigest: sha256:91d33d4bf5374a4c943d4457f353611b0103b6b64ee574f88a63b0c4ccf15a03
+        sourceRevisionDigest: sha256:aa8d55b08881b9cb4a9a2733ef4bb30ec2d431e3947e5328e7cfd0883536cb8b
+        sourceBlobDigest: sha256:0beab37bb2d9c1fa7004085fba7408fba5ef91efc9d3598e99d6bda70c654795
         tags:
             - latest
-            - speakeasy-sdk-regen-dev-1760532149
-            - 4.15.0-alpha.1760486888592-e1e43793
+            - speakeasy-sdk-regen-dev-1760576200
+            - 4.15.0-alpha.1760569726872-c3466a59
 targets:
     cribl-control-plane:
         source: Cribl API Reference
         sourceNamespace: cribl-api-reference
-        sourceRevisionDigest: sha256:5b78d074d97a6f3f04525bd9fa58d282fc38230c91b70f45b3d39ae1c69d1a40
-        sourceBlobDigest: sha256:91d33d4bf5374a4c943d4457f353611b0103b6b64ee574f88a63b0c4ccf15a03
+        sourceRevisionDigest: sha256:aa8d55b08881b9cb4a9a2733ef4bb30ec2d431e3947e5328e7cfd0883536cb8b
+        sourceBlobDigest: sha256:0beab37bb2d9c1fa7004085fba7408fba5ef91efc9d3598e99d6bda70c654795
         codeSamplesNamespace: cribl-api-reference-python-code-samples
-        codeSamplesRevisionDigest: sha256:78bbb016992d0e25b0e82b0dc340895be5f5f0ed9e2e9e36b92d253b5373deed
+        codeSamplesRevisionDigest: sha256:15583f9d042e94bdeb7698a492154f7fa51095dada52ae8ae461d03b80f7c38d
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: 1.636.3

README-PYPI.md

@@ -14,6 +14,7 @@ Cribl API Reference: This API Reference lists available REST endpoints, along wi
   * [SDK Example Usage](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#sdk-example-usage)
   * [Authentication](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#authentication)
   * [Available Resources and Operations](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#available-resources-and-operations)
+  * [File uploads](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#file-uploads)
   * [Retries](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#retries)
   * [Error Handling](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#error-handling)
   * [Custom HTTP Client](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#custom-http-client)
@@ -354,8 +355,9 @@ with CriblControlPlane(
 
 ### [packs](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md)
 
-* [install](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#install) - Create or install a Pack
+* [install](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#install) - Install a Pack
 * [list](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#list) - List all Packs
+* [upload](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#upload) - Upload a Pack file
 * [delete](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#delete) - Uninstall a Pack
 * [get](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#get) - Get a Pack
 * [update](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/docs/sdks/packs/README.md#update) - Upgrade a Pack
@@ -419,6 +421,36 @@ with CriblControlPlane(
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
+<!-- Start File uploads [file-upload] -->
+## File uploads
+
+Certain SDK methods accept file objects as part of a request body or multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
+
+> [!TIP]
+>
+> For endpoints that handle file uploads bytes arrays can also be used. However, using streams is recommended for large files.
+>
+
+```python
+from cribl_control_plane import CriblControlPlane, models
+import os
+
+
+with CriblControlPlane(
+    server_url="https://api.example.com",
+    security=models.Security(
+        bearer_auth=os.getenv("CRIBLCONTROLPLANE_BEARER_AUTH", ""),
+    ),
+) as ccp_client:
+
+    res = ccp_client.packs.upload(filename="example.file", request_body=open("example.file", "rb"))
+
+    # Handle response
+    print(res)
+
+```
+<!-- End File uploads [file-upload] -->
+
 <!-- Start Retries [retries] -->
 ## Retries
 
@@ -632,7 +664,7 @@ with CriblControlPlane(
 
 
 **Inherit from [`CriblControlPlaneError`](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/./src/cribl_control_plane/errors/criblcontrolplaneerror.py)**:
-* [`HealthStatusError`](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/./src/cribl_control_plane/errors/healthstatuserror.py): Healthy status. Status code `420`. Applicable to 1 of 62 methods.*
+* [`HealthStatusError`](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/./src/cribl_control_plane/errors/healthstatuserror.py): Healthy status. Status code `420`. Applicable to 1 of 63 methods.*
 * [`ResponseValidationError`](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/./src/cribl_control_plane/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>

README.md

@@ -14,6 +14,7 @@ Cribl API Reference: This API Reference lists available REST endpoints, along wi
   * [SDK Example Usage](#sdk-example-usage)
   * [Authentication](#authentication)
   * [Available Resources and Operations](#available-resources-and-operations)
+  * [File uploads](#file-uploads)
   * [Retries](#retries)
   * [Error Handling](#error-handling)
   * [Custom HTTP Client](#custom-http-client)
@@ -354,8 +355,9 @@ with CriblControlPlane(
 
 ### [packs](docs/sdks/packs/README.md)
 
-* [install](docs/sdks/packs/README.md#install) - Create or install a Pack
+* [install](docs/sdks/packs/README.md#install) - Install a Pack
 * [list](docs/sdks/packs/README.md#list) - List all Packs
+* [upload](docs/sdks/packs/README.md#upload) - Upload a Pack file
 * [delete](docs/sdks/packs/README.md#delete) - Uninstall a Pack
 * [get](docs/sdks/packs/README.md#get) - Get a Pack
 * [update](docs/sdks/packs/README.md#update) - Upgrade a Pack
@@ -419,6 +421,36 @@ with CriblControlPlane(
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
+<!-- Start File uploads [file-upload] -->
+## File uploads
+
+Certain SDK methods accept file objects as part of a request body or multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
+
+> [!TIP]
+>
+> For endpoints that handle file uploads bytes arrays can also be used. However, using streams is recommended for large files.
+>
+
+```python
+from cribl_control_plane import CriblControlPlane, models
+import os
+
+
+with CriblControlPlane(
+    server_url="https://api.example.com",
+    security=models.Security(
+        bearer_auth=os.getenv("CRIBLCONTROLPLANE_BEARER_AUTH", ""),
+    ),
+) as ccp_client:
+
+    res = ccp_client.packs.upload(filename="example.file", request_body=open("example.file", "rb"))
+
+    # Handle response
+    print(res)
+
+```
+<!-- End File uploads [file-upload] -->
+
 <!-- Start Retries [retries] -->
 ## Retries
 
@@ -632,7 +664,7 @@ with CriblControlPlane(
 
 
 **Inherit from [`CriblControlPlaneError`](./src/cribl_control_plane/errors/criblcontrolplaneerror.py)**:
-* [`HealthStatusError`](./src/cribl_control_plane/errors/healthstatuserror.py): Healthy status. Status code `420`. Applicable to 1 of 62 methods.*
+* [`HealthStatusError`](./src/cribl_control_plane/errors/healthstatuserror.py): Healthy status. Status code `420`. Applicable to 1 of 63 methods.*
 * [`ResponseValidationError`](./src/cribl_control_plane/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>

RELEASES.md

@@ -468,4 +468,14 @@ Based on:
 ### Generated
 - [python v0.2.0b4] .
 ### Releases
-- [PyPI v0.2.0b4] https://pypi.org/project/cribl-control-plane/0.2.0b4 - .
+- [PyPI v0.2.0b4] https://pypi.org/project/cribl-control-plane/0.2.0b4 - .
+
+## 2025-10-16 00:56:17
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.636.3 (2.723.11) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.2.0b5] .
+### Releases
+- [PyPI v0.2.0b5] https://pypi.org/project/cribl-control-plane/0.2.0b5 - .

docs/models/packinfotags.md

@@ -5,7 +5,7 @@
 
 | Field              | Type               | Required           | Description        |
 | ------------------ | ------------------ | ------------------ | ------------------ |
-| `data_type`        | List[*str*]        | :heavy_check_mark: | N/A                |
+| `data_type`        | List[*str*]        | :heavy_minus_sign: | N/A                |
 | `domain`           | List[*str*]        | :heavy_minus_sign: | N/A                |
 | `streamtags`       | List[*str*]        | :heavy_minus_sign: | N/A                |
 | `technology`       | List[*str*]        | :heavy_minus_sign: | N/A                |

docs/models/packinstallinfotags.md

@@ -5,7 +5,7 @@
 
 | Field              | Type               | Required           | Description        |
 | ------------------ | ------------------ | ------------------ | ------------------ |
-| `data_type`        | List[*str*]        | :heavy_check_mark: | N/A                |
+| `data_type`        | List[*str*]        | :heavy_minus_sign: | N/A                |
 | `domain`           | List[*str*]        | :heavy_minus_sign: | N/A                |
 | `streamtags`       | List[*str*]        | :heavy_minus_sign: | N/A                |
 | `technology`       | List[*str*]        | :heavy_minus_sign: | N/A                |

docs/models/updatepacksrequest.md

@@ -0,0 +1,9 @@
+# UpdatePacksRequest
+
+
+## Fields
+
+| Field                                        | Type                                         | Required                                     | Description                                  |
+| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
+| `filename`                                   | *str*                                        | :heavy_check_mark:                           | Filename of the Pack file to upload.         |
+| `request_body`                               | *Union[bytes, IO[bytes], io.BufferedReader]* | :heavy_check_mark:                           | Binary file content                          |