langflow-control-plane-sdk 0.0.0.dev2__tar.gz → 0.1.1__tar.gz

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: langflow-control-plane-sdk
-Version: 0.0.0.dev2
+Version: 0.1.1
 Summary: Generated async Python client for the Langflow Control Plane API
 License-Expression: MIT
 License-File: LICENSE
@@ -36,21 +36,40 @@ release-candidate builds, or install an exact version such as
 
 ## Configure
 
-Set the Control Plane base URL and its temporary pass-through `x-api-key`
-credential on the generated configuration:
+Set the Control Plane base URL and the bearer token the authoring plane minted
+for the caller:
 
 ```python
 import langflow_control_plane_sdk as control_plane
 
 configuration = control_plane.Configuration(
     host="https://control-plane.example",
-    api_key={"LangflowAPIKey": "replace-me"},
+    access_token="replace-me",
 )
 ```
 
-The key is sent as `x-api-key`; do not log it. This pass-through authentication
-scheme is temporary. A future authentication change can affect SDK users and is
-therefore treated as semver-significant.
+The token is sent as `Authorization: Bearer ...`; do not log it. The Control
+Plane verifies it against the one JWKS issuer it trusts, and calls Langflow with
+its own service credential rather than forwarding anything the client supplied.
+An authentication change affects SDK users and is treated as semver-significant.
+
+### Pass-through planes
+
+A Control Plane started with `LANGFLOW_CONTROL_PLANE_AUTH_MODE=passthrough` — the
+local development mode — does not verify a bearer token at all. It requires a
+Langflow API key in `x-api-key` and forwards that key to Langflow unchanged. The
+contract declares only the bearer scheme, so the generated `Configuration` has no
+field for it; set it as a default header on the client:
+
+```python
+client = control_plane.ApiClient(configuration)
+client.default_headers["x-api-key"] = "your-langflow-api-key"
+```
+
+Without that header a pass-through plane answers `401 UNAUTHENTICATED` no matter
+what `access_token` is set to, which is otherwise an unexplained rejection. Do
+not send the key to a plane running in `idp` mode: there it is ignored, and the
+bearer token is the only credential read.
 
 ## Async CRUD
 

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/README.md

@@ -18,21 +18,40 @@ release-candidate builds, or install an exact version such as
 
 ## Configure
 
-Set the Control Plane base URL and its temporary pass-through `x-api-key`
-credential on the generated configuration:
+Set the Control Plane base URL and the bearer token the authoring plane minted
+for the caller:
 
 ```python
 import langflow_control_plane_sdk as control_plane
 
 configuration = control_plane.Configuration(
     host="https://control-plane.example",
-    api_key={"LangflowAPIKey": "replace-me"},
+    access_token="replace-me",
 )
 ```
 
-The key is sent as `x-api-key`; do not log it. This pass-through authentication
-scheme is temporary. A future authentication change can affect SDK users and is
-therefore treated as semver-significant.
+The token is sent as `Authorization: Bearer ...`; do not log it. The Control
+Plane verifies it against the one JWKS issuer it trusts, and calls Langflow with
+its own service credential rather than forwarding anything the client supplied.
+An authentication change affects SDK users and is treated as semver-significant.
+
+### Pass-through planes
+
+A Control Plane started with `LANGFLOW_CONTROL_PLANE_AUTH_MODE=passthrough` — the
+local development mode — does not verify a bearer token at all. It requires a
+Langflow API key in `x-api-key` and forwards that key to Langflow unchanged. The
+contract declares only the bearer scheme, so the generated `Configuration` has no
+field for it; set it as a default header on the client:
+
+```python
+client = control_plane.ApiClient(configuration)
+client.default_headers["x-api-key"] = "your-langflow-api-key"
+```
+
+Without that header a pass-through plane answers `401 UNAUTHENTICATED` no matter
+what `access_token` is set to, which is otherwise an unexplained rejection. Do
+not send the key to a plane running in `idp` mode: there it is ignored, and the
+bearer token is the only credential read.
 
 ## Async CRUD
 

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "0.0.0.dev2"
+__version__ = "0.1.1"
 
 # Define package exports
 __all__ = [

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/api/deployments_api.py

@@ -325,7 +325,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(
@@ -604,7 +604,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(
@@ -902,7 +902,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(
@@ -1178,7 +1178,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(
@@ -1490,7 +1490,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(
@@ -1806,7 +1806,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(
@@ -2125,7 +2125,7 @@ class DeploymentsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'LangflowAPIKey'
+            'ControlPlaneToken'
         ]
 
         return self.api_client.param_serialize(

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/0.0.0.dev2/python'
+        self.user_agent = 'OpenAPI-Generator/0.1.1/python'
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/configuration.py

@@ -110,7 +110,7 @@ HTTPSignatureAuthSetting = TypedDict(
 AuthSettings = TypedDict(
     "AuthSettings",
     {
-        "LangflowAPIKey": APIKeyAuthSetting,
+        "ControlPlaneToken": BearerFormatAuthSetting,
     },
     total=False,
 )
@@ -176,25 +176,6 @@ class Configuration:
     :param date_format: Date format string for serialization.
 
     :Example:
-
-    API Key Authentication Example.
-    Given the following security scheme in the OpenAPI specification:
-      components:
-        securitySchemes:
-          cookieAuth:         # name for the security scheme
-            type: apiKey
-            in: cookie
-            name: JSESSIONID  # cookie name
-
-    You can programmatically set the cookie:
-
-conf = langflow_control_plane_sdk.Configuration(
-    api_key={'cookieAuth': 'abc123'}
-    api_key_prefix={'cookieAuth': 'JSESSIONID'}
-)
-
-    The following cookie will be added to the HTTP request:
-       Cookie: JSESSIONID abc123
     """
 
     _default: ClassVar[Optional[Self]] = None
@@ -533,14 +514,13 @@ conf = langflow_control_plane_sdk.Configuration(
         :return: The Auth Settings information dict.
         """
         auth: AuthSettings = {}
-        if 'LangflowAPIKey' in self.api_key:
-            auth['LangflowAPIKey'] = {
-                'type': 'api_key',
+        if self.access_token is not None:
+            auth['ControlPlaneToken'] = {
+                'type': 'bearer',
                 'in': 'header',
-                'key': 'x-api-key',
-                'value': self.get_api_key_with_prefix(
-                    'LangflowAPIKey',
-                ),
+                'format': 'JWT',
+                'key': 'Authorization',
+                'value': 'Bearer ' + self.access_token
             }
         return auth
 
@@ -553,7 +533,7 @@ conf = langflow_control_plane_sdk.Configuration(
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 0.0\n"\
-               "SDK Package Version: 0.0.0.dev2".\
+               "SDK Package Version: 0.1.1".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/models/create_deployment.py

@@ -31,7 +31,7 @@ class CreateDeployment(BaseModel):
     CreateDeployment
     """ # noqa: E501
     project_id: UUID = Field(description="Langflow project ID used as the Deployment ID.", alias="projectId")
-    slug: Annotated[str, Field(min_length=1, strict=True, max_length=63)]
+    slug: Annotated[str, Field(min_length=1, strict=True, max_length=63)] = Field(description="Stable, caller-visible name for one deployment, unique within the plane. It is a key, not a display name: it is the only identifier a stateless client can reconstruct between invocations, so it must not be derived from a project name. Names are free text, and `My Project`, `my-project`, and `MY  PROJECT!` all reduce to the same slug while anything past 63 characters truncates into further collisions. Supply one, or let the plane generate one and read it back from the response.")
     description: Optional[Annotated[str, Field(strict=True, max_length=4096)]] = None
     flows: List[Flow]
     __properties: ClassVar[List[str]] = ["projectId", "slug", "description", "flows"]

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/models/deployment_detail.py

@@ -31,7 +31,7 @@ class DeploymentDetail(BaseModel):
     DeploymentDetail
     """ # noqa: E501
     id: UUID
-    slug: Annotated[str, Field(min_length=1, strict=True, max_length=63)]
+    slug: Annotated[str, Field(min_length=1, strict=True, max_length=63)] = Field(description="Stable, caller-visible name for one deployment, unique within the plane. It is a key, not a display name: it is the only identifier a stateless client can reconstruct between invocations, so it must not be derived from a project name. Names are free text, and `My Project`, `my-project`, and `MY  PROJECT!` all reduce to the same slug while anything past 63 characters truncates into further collisions. Supply one, or let the plane generate one and read it back from the response.")
     description: Optional[Annotated[str, Field(strict=True, max_length=4096)]] = None
     flows: List[FlowRef]
     runtime_base_url: StrictStr = Field(alias="runtimeBaseUrl")

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/models/deployment_list_item.py

@@ -30,7 +30,7 @@ class DeploymentListItem(BaseModel):
     DeploymentListItem
     """ # noqa: E501
     id: UUID
-    slug: Annotated[str, Field(min_length=1, strict=True, max_length=63)]
+    slug: Annotated[str, Field(min_length=1, strict=True, max_length=63)] = Field(description="Stable, caller-visible name for one deployment, unique within the plane. It is a key, not a display name: it is the only identifier a stateless client can reconstruct between invocations, so it must not be derived from a project name. Names are free text, and `My Project`, `my-project`, and `MY  PROJECT!` all reduce to the same slug while anything past 63 characters truncates into further collisions. Supply one, or let the plane generate one and read it back from the response.")
     description: Optional[Annotated[str, Field(strict=True, max_length=4096)]] = None
     runtime_base_url: StrictStr = Field(alias="runtimeBaseUrl")
     __properties: ClassVar[List[str]] = ["id", "slug", "description", "runtimeBaseUrl"]

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/langflow_control_plane_sdk/models/error_code.py

@@ -34,13 +34,16 @@ class ErrorCode(str, Enum):
     DEPLOYMENT_NOT_FOUND = 'DEPLOYMENT_NOT_FOUND'
     DEPLOYMENT_SLUG_CONFLICT = 'DEPLOYMENT_SLUG_CONFLICT'
     FLOW_ID_CONFLICT = 'FLOW_ID_CONFLICT'
+    FLOW_NAME_CONFLICT = 'FLOW_NAME_CONFLICT'
     VALIDATION_FAILED = 'VALIDATION_FAILED'
     REQUEST_TOO_LARGE = 'REQUEST_TOO_LARGE'
     LANGFLOW_ERROR = 'LANGFLOW_ERROR'
+    LANGFLOW_CONFLICT = 'LANGFLOW_CONFLICT'
     LANGFLOW_INVALID_REQUEST = 'LANGFLOW_INVALID_REQUEST'
     LANGFLOW_VALIDATION_FAILED = 'LANGFLOW_VALIDATION_FAILED'
     LANGFLOW_UNAUTHENTICATED = 'LANGFLOW_UNAUTHENTICATED'
     LANGFLOW_FORBIDDEN = 'LANGFLOW_FORBIDDEN'
+    LANGFLOW_PROJECT_ID_CONFLICT = 'LANGFLOW_PROJECT_ID_CONFLICT'
     LANGFLOW_PROJECT_ROLLBACK_FAILED = 'LANGFLOW_PROJECT_ROLLBACK_FAILED'
     LANGFLOW_RATE_LIMITED = 'LANGFLOW_RATE_LIMITED'
     LANGFLOW_SERVICE_ERROR = 'LANGFLOW_SERVICE_ERROR'

{langflow_control_plane_sdk-0.0.0.dev2 → langflow_control_plane_sdk-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langflow-control-plane-sdk"
-version = "0.0.0.dev2"
+version = "0.1.1"
 description = "Generated async Python client for the Langflow Control Plane API"
 license = "MIT"
 license-files = ["LICENSE"]