scalekit-sdk-python 2.4.1__tar.gz → 2.4.3__tar.gz

scalekit_sdk_python-2.4.3/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: scalekit-sdk-python
+Version: 2.4.3
+Summary: Scalekit official Python SDK
+Home-page: https://github.com/scalekit-inc/scalekit-sdk-python
+Author: Team Scalekit
+Author-email: support@scalekit.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: grpcio>=1.64.1
+Requires-Dist: protobuf<6.0.0,>=5.26.1
+Requires-Dist: google>=3.0
+Requires-Dist: requests>=2.32.3
+Requires-Dist: PyJWT<2.10,>=2.8
+Requires-Dist: cffi>=1.15.1
+Requires-Dist: cryptography==45.0.6
+Requires-Dist: setuptools>=78.1.1
+Requires-Dist: grpcio-status<1.67,>=1.64
+Requires-Dist: protoc-gen-openapiv2>=0.0.1
+Requires-Dist: googleapis-common-protos<1.66.0,>=1.56.1
+Requires-Dist: deprecation>=2.1.0
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: Faker~=25.8.0
+Requires-Dist: pydantic~=2.11.2
+Requires-Dist: langchain-core<0.4,>=0.3.36
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+<p align="left">
+  <a href="https://scalekit.com" target="_blank" rel="noopener noreferrer">
+    <picture>
+      <img src="https://cdn.scalekit.cloud/v1/scalekit-logo-dark.svg" height="64">
+    </picture>
+  </a>
+  <br/>
+</p>
+
+# Official Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/scalekit-sdk-python.svg?style=flat-square)](https://pypi.org/project/scalekit-sdk-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python versions](https://img.shields.io/pypi/pyversions/scalekit-sdk-python.svg?style=flat-square)](https://pypi.org/project/scalekit-sdk-python/)
+
+<a href="https://scalekit.com" target="_blank" rel="noopener noreferrer">Scalekit</a> is the **auth stack for AI apps** - from human authentication to agent authorization. Build secure AI products faster with authentication for humans (SSO, passwordless, full-stack auth) and agents (MCP/APIs, delegated actions), all unified on one platform. This Python SDK enables both traditional B2B authentication and cutting-edge agentic workflows.
+
+## 🤖 Agent-First Features
+
+- **🔐 Agent Identity**: Agents as first-class actors with human ownership and org context
+- **🎯 MCP-Native OAuth 2.1**: Purpose-built for Model Context Protocol with DCR/PKCE support
+- **⏰ Ephemeral Credentials**: Time-bound, task-based authorization (minutes, not days)
+- **🔒 Token Vault**: Per-user, per-tool token storage with rotation and progressive consent
+- **👥 Human-in-the-Loop**: Step-up authentication when risk crosses thresholds
+- **📊 Immutable Audit**: Track which user initiated, which agent acted, what resource was accessed
+
+## 👨‍💼 Human Authentication
+
+- **🔐 Enterprise SSO**: Support for SAML and OIDC protocols
+- **👥 SCIM Provisioning**: Automated user provisioning and deprovisioning  
+- **🚀 Passwordless Authentication**: Magic links, OTP, and modern auth flows
+- **🏢 Multi-tenant Architecture**: Organization-level authentication policies
+- **📱 Social Logins**: Support for popular social identity providers
+- **🛡️ Full-Stack Auth**: Complete IdP-of-record solution for B2B SaaS
+- **🐍 Pythonic API**: Clean, intuitive interface following Python conventions
+
+<div>
+📚 <a target="_blank" href="https://docs.scalekit.com">Documentation</a> • 🚀 <a target="_blank" href="https://docs.scalekit.com/sso/quickstart/">SSO Quickstart</a> • 💻 <a target="_blank" href="https://docs.scalekit.com/apis">API Reference</a>
+</div>
+<hr />
+
+## Pre-requisites
+
+1. [Sign up](https://scalekit.com) for a Scalekit account.
+2. Get your ```env_url```, ```client_id``` and ```client_secret``` from the Scalekit dashboard.
+
+## Installation
+
+Install Scalekit SDK using your preferred package manager. 
+
+```sh
+pip install scalekit-sdk-python
+
+```
+
+## Usage
+
+```py
+
+from scalekit import ScalekitClient
+
+sc = ScalekitClient(
+  env_url, 
+  client_id, 
+  client_secret
+)
+
+# Use the sc object to interact with the Scalekit API
+auth_url = sc.get_authorization_url(
+  "https://acme-corp.com/redirect-uri",
+  state="state",
+  connection_id="con_123456789"
+)
+
+```
+
+##### Minimum Requirements
+
+To use the Scalekit Python SDK, you must have the following:
+
+| Component | Version |
+| --------- | ------- |
+| Python    | 3.8+    |
+
+> **Tip:** Although Python 3.8 meets the minimum requirement, using a more recent version (such as Python 3.9 or later) is advisable.
+
+
+## Examples - SSO with FastAPI
+
+Below is a simple code sample that showcases how to implement Single Sign-on using Scalekit SDK
+
+```py
+from fastapi import FastAPI, Request, Response
+from scalekit import ScalekitClient
+import uvicorn
+
+app = FastAPI()
+
+sc = ScalekitClient(
+  env_url, 
+  client_id, 
+  client_secret
+)
+
+redirect_uri = "http://localhost:8000/auth/callback"
+
+@app.get("/auth/login")
+async def auth_login(request: Request):
+  auth_url = sc.get_authorization_url(
+    redirect_uri,
+    state="state",
+    connection_id="con_123456789"
+  )
+  return Response(status_code=302, headers={"Location": auth_url})
+
+@app.get("/auth/callback")
+async def auth_callback(request: Request):
+  code = request.query_params.get("code")
+  token = sc.authenticate_with_code(
+    code, 
+    redirect_uri
+  )
+  response = JSONResponse(content=token)
+  response.set_cookie("access_token", token["access_token"])
+
+  return response
+
+if __name__ == "__main__":
+  uvicorn.run(app, port=8080)
+
+```
+
+## 📱 Example Apps
+
+Explore fully functional sample applications built with popular Python frameworks and the Scalekit SDK:
+
+| Framework | Repository | Description |
+|-----------|------------|-------------|
+| **FastAPI** | [scalekit-fastapi-example](https://github.com/scalekit-developers/scalekit-fastapi-example) | Modern async Python API framework |
+
+## 🔗 Helpful Links
+
+### 📖 Quickstart Guides
+- [**SSO Integration**](https://docs.scalekit.com/sso/quickstart/) - Implement enterprise Single Sign-on
+- [**Full Stack Auth**](https://docs.scalekit.com/fsa/quickstart/) - Complete authentication solution
+- [**Passwordless Auth**](https://docs.scalekit.com/passwordless/quickstart/) - Modern authentication flows
+- [**Social Logins**](https://docs.scalekit.com/social-logins/quickstart/) - Popular social identity providers
+- [**Machine-to-Machine**](https://docs.scalekit.com/m2m/quickstart/) - API authentication
+
+### 📚 Documentation & Reference
+- [**API Reference**](https://docs.scalekit.com/apis) - Complete API documentation
+- [**Developer Kit**](https://docs.scalekit.com/dev-kit/) - Tools and utilities
+- [**API Authentication Guide**](https://docs.scalekit.com/guides/authenticate-scalekit-api/) - Secure API access
+
+### 🛠️ Additional Resources
+- [**Setup Guide**](https://docs.scalekit.com/guides/setup-scalekit/) - Initial platform configuration
+- [**Code Examples**](https://docs.scalekit.com/directory/code-examples/) - Ready-to-use code snippets
+- [**Admin Portal Guide**](https://docs.scalekit.com/directory/guides/admin-portal/) - Administrative interface
+- [**Launch Checklist**](https://docs.scalekit.com/directory/guides/launch-checklist/) - Pre-production checklist
+
+## License
+
+This project is licensed under the **MIT license**.
+See the [LICENSE](LICENSE) file for more information.

scalekit_sdk_python-2.4.3/README.md

@@ -0,0 +1,164 @@
+<p align="left">
+  <a href="https://scalekit.com" target="_blank" rel="noopener noreferrer">
+    <picture>
+      <img src="https://cdn.scalekit.cloud/v1/scalekit-logo-dark.svg" height="64">
+    </picture>
+  </a>
+  <br/>
+</p>
+
+# Official Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/scalekit-sdk-python.svg?style=flat-square)](https://pypi.org/project/scalekit-sdk-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python versions](https://img.shields.io/pypi/pyversions/scalekit-sdk-python.svg?style=flat-square)](https://pypi.org/project/scalekit-sdk-python/)
+
+<a href="https://scalekit.com" target="_blank" rel="noopener noreferrer">Scalekit</a> is the **auth stack for AI apps** - from human authentication to agent authorization. Build secure AI products faster with authentication for humans (SSO, passwordless, full-stack auth) and agents (MCP/APIs, delegated actions), all unified on one platform. This Python SDK enables both traditional B2B authentication and cutting-edge agentic workflows.
+
+## 🤖 Agent-First Features
+
+- **🔐 Agent Identity**: Agents as first-class actors with human ownership and org context
+- **🎯 MCP-Native OAuth 2.1**: Purpose-built for Model Context Protocol with DCR/PKCE support
+- **⏰ Ephemeral Credentials**: Time-bound, task-based authorization (minutes, not days)
+- **🔒 Token Vault**: Per-user, per-tool token storage with rotation and progressive consent
+- **👥 Human-in-the-Loop**: Step-up authentication when risk crosses thresholds
+- **📊 Immutable Audit**: Track which user initiated, which agent acted, what resource was accessed
+
+## 👨‍💼 Human Authentication
+
+- **🔐 Enterprise SSO**: Support for SAML and OIDC protocols
+- **👥 SCIM Provisioning**: Automated user provisioning and deprovisioning  
+- **🚀 Passwordless Authentication**: Magic links, OTP, and modern auth flows
+- **🏢 Multi-tenant Architecture**: Organization-level authentication policies
+- **📱 Social Logins**: Support for popular social identity providers
+- **🛡️ Full-Stack Auth**: Complete IdP-of-record solution for B2B SaaS
+- **🐍 Pythonic API**: Clean, intuitive interface following Python conventions
+
+<div>
+📚 <a target="_blank" href="https://docs.scalekit.com">Documentation</a> • 🚀 <a target="_blank" href="https://docs.scalekit.com/sso/quickstart/">SSO Quickstart</a> • 💻 <a target="_blank" href="https://docs.scalekit.com/apis">API Reference</a>
+</div>
+<hr />
+
+## Pre-requisites
+
+1. [Sign up](https://scalekit.com) for a Scalekit account.
+2. Get your ```env_url```, ```client_id``` and ```client_secret``` from the Scalekit dashboard.
+
+## Installation
+
+Install Scalekit SDK using your preferred package manager. 
+
+```sh
+pip install scalekit-sdk-python
+
+```
+
+## Usage
+
+```py
+
+from scalekit import ScalekitClient
+
+sc = ScalekitClient(
+  env_url, 
+  client_id, 
+  client_secret
+)
+
+# Use the sc object to interact with the Scalekit API
+auth_url = sc.get_authorization_url(
+  "https://acme-corp.com/redirect-uri",
+  state="state",
+  connection_id="con_123456789"
+)
+
+```
+
+##### Minimum Requirements
+
+To use the Scalekit Python SDK, you must have the following:
+
+| Component | Version |
+| --------- | ------- |
+| Python    | 3.8+    |
+
+> **Tip:** Although Python 3.8 meets the minimum requirement, using a more recent version (such as Python 3.9 or later) is advisable.
+
+
+## Examples - SSO with FastAPI
+
+Below is a simple code sample that showcases how to implement Single Sign-on using Scalekit SDK
+
+```py
+from fastapi import FastAPI, Request, Response
+from scalekit import ScalekitClient
+import uvicorn
+
+app = FastAPI()
+
+sc = ScalekitClient(
+  env_url, 
+  client_id, 
+  client_secret
+)
+
+redirect_uri = "http://localhost:8000/auth/callback"
+
+@app.get("/auth/login")
+async def auth_login(request: Request):
+  auth_url = sc.get_authorization_url(
+    redirect_uri,
+    state="state",
+    connection_id="con_123456789"
+  )
+  return Response(status_code=302, headers={"Location": auth_url})
+
+@app.get("/auth/callback")
+async def auth_callback(request: Request):
+  code = request.query_params.get("code")
+  token = sc.authenticate_with_code(
+    code, 
+    redirect_uri
+  )
+  response = JSONResponse(content=token)
+  response.set_cookie("access_token", token["access_token"])
+
+  return response
+
+if __name__ == "__main__":
+  uvicorn.run(app, port=8080)
+
+```
+
+## 📱 Example Apps
+
+Explore fully functional sample applications built with popular Python frameworks and the Scalekit SDK:
+
+| Framework | Repository | Description |
+|-----------|------------|-------------|
+| **FastAPI** | [scalekit-fastapi-example](https://github.com/scalekit-developers/scalekit-fastapi-example) | Modern async Python API framework |
+
+## 🔗 Helpful Links
+
+### 📖 Quickstart Guides
+- [**SSO Integration**](https://docs.scalekit.com/sso/quickstart/) - Implement enterprise Single Sign-on
+- [**Full Stack Auth**](https://docs.scalekit.com/fsa/quickstart/) - Complete authentication solution
+- [**Passwordless Auth**](https://docs.scalekit.com/passwordless/quickstart/) - Modern authentication flows
+- [**Social Logins**](https://docs.scalekit.com/social-logins/quickstart/) - Popular social identity providers
+- [**Machine-to-Machine**](https://docs.scalekit.com/m2m/quickstart/) - API authentication
+
+### 📚 Documentation & Reference
+- [**API Reference**](https://docs.scalekit.com/apis) - Complete API documentation
+- [**Developer Kit**](https://docs.scalekit.com/dev-kit/) - Tools and utilities
+- [**API Authentication Guide**](https://docs.scalekit.com/guides/authenticate-scalekit-api/) - Secure API access
+
+### 🛠️ Additional Resources
+- [**Setup Guide**](https://docs.scalekit.com/guides/setup-scalekit/) - Initial platform configuration
+- [**Code Examples**](https://docs.scalekit.com/directory/code-examples/) - Ready-to-use code snippets
+- [**Admin Portal Guide**](https://docs.scalekit.com/directory/guides/admin-portal/) - Administrative interface
+- [**Launch Checklist**](https://docs.scalekit.com/directory/guides/launch-checklist/) - Pre-production checklist
+
+## License
+
+This project is licensed under the **MIT license**.
+See the [LICENSE](LICENSE) file for more information.

scalekit_sdk_python-2.4.3/scalekit/actions/__init__.py

@@ -0,0 +1,6 @@
+from .actions import ActionClient
+from .models import *
+
+__all__ = [
+    'ActionClient',
+]

scalekit_sdk_python-2.4.1/scalekit/connect/connect.py → scalekit_sdk_python-2.4.3/scalekit/actions/actions.py

@@ -2,27 +2,27 @@ from typing import Optional, Any, List, Dict
 from scalekit.v1.mcp.mcp_pb2 import Mcp
 from scalekit.v1.mcp.mcp_pb2 import ToolMapping as ProtoToolMapping
 
-from scalekit.connect.models.tool_mapping import ToolMapping
-from scalekit.connect.types import ToolRequest,ExecuteToolResponse,MagicLinkResponse,ListConnectedAccountsResponse,DeleteConnectedAccountResponse,GetConnectedAccountAuthResponse,ToolInput, \
+from scalekit.actions.models.tool_mapping import ToolMapping
+from scalekit.actions.types import ToolRequest,ExecuteToolResponse,MagicLinkResponse,ListConnectedAccountsResponse,DeleteConnectedAccountResponse,GetConnectedAccountAuthResponse,ToolInput, \
     McpRequest,CreateMcpResponse,GetMcpResponse
-from scalekit.connect.models.responses.create_connected_account_response import CreateConnectedAccountResponse
-from scalekit.connect.models.requests.create_connected_account_request import CreateConnectedAccountRequest
-from scalekit.connect.modifier import (
+from scalekit.actions.models.responses.create_connected_account_response import CreateConnectedAccountResponse
+from scalekit.actions.models.requests.create_connected_account_request import CreateConnectedAccountRequest
+from scalekit.actions.modifier import (
     Modifier, ModifierType, ToolNames,
     apply_pre_modifiers, apply_post_modifiers
 )
-from scalekit.connect.frameworks.langchain import LangChain
+from scalekit.actions.frameworks.langchain import LangChain
 from scalekit.common.exceptions import ScalekitNotFoundException
 
 
 
 
-class ConnectClient:
+class ActionClient:
     """Class definition for Connect Client"""
 
     def __init__(self,tools_client, connected_accounts_client, mcp_client=None):
         """
-        Initialize ConnectClient with tools, connected accounts, and MCP dependencies
+        Initialize ActionClient with tools, connected accounts, and MCP dependencies
         
         :param tools_client: ToolsClient instance
         :type: ToolsClient

{scalekit_sdk_python-2.4.1/scalekit/connect → scalekit_sdk_python-2.4.3/scalekit/actions}/frameworks/langchain.py

@@ -77,7 +77,7 @@ class LangChain:
         def _call(**arguments: Dict[str, Any]) -> str:
             try:
                 # Import here to avoid circular imports
-                from scalekit.connect.types import ToolInput
+                from scalekit.actions.types import ToolInput
 
                 
                 # Call connect.execute_tool via callback (includes modifiers and enhanced handling)

{scalekit_sdk_python-2.4.1/scalekit/connect → scalekit_sdk_python-2.4.3/scalekit/actions}/models/requests/mcp_request.py

@@ -1,7 +1,7 @@
 from typing import Optional, List
 from pydantic import BaseModel, Field, field_validator
 
-from scalekit.connect.models.tool_mapping import ToolMapping
+from scalekit.actions.models.tool_mapping import ToolMapping
 
 # TODO: Add validation for tool_mappings to ensure unique tool names across mappings
 class McpRequest(BaseModel):

{scalekit_sdk_python-2.4.1/scalekit/connect → scalekit_sdk_python-2.4.3/scalekit/actions}/models/responses/create_mcp_response.py

@@ -1,8 +1,8 @@
 from typing import Optional, Dict, Any, List
 from pydantic import BaseModel, Field
-from google.protobuf.json_format import MessageToDict
 
-from scalekit.connect.models.tool_mapping import ToolMapping
+
+from scalekit.actions.models.tool_mapping import ToolMapping
 
 
 class CreateMcpResponse(BaseModel):

{scalekit_sdk_python-2.4.1/scalekit/connect → scalekit_sdk_python-2.4.3/scalekit/actions}/models/responses/get_mcp_response.py

@@ -2,7 +2,7 @@ from typing import Optional, Dict, Any, List
 from pydantic import BaseModel, Field
 from google.protobuf.json_format import MessageToDict
 
-from scalekit.connect.models.tool_mapping import ToolMapping
+from scalekit.actions.models.tool_mapping import ToolMapping
 
 
 class GetMcpResponse(BaseModel):

{scalekit_sdk_python-2.4.1 → scalekit_sdk_python-2.4.3}/scalekit/client.py

@@ -16,11 +16,13 @@ from scalekit.organization import OrganizationClient
 from scalekit.directory import DirectoryClient
 from scalekit.users import UserClient
 from scalekit.role import RoleClient
+from scalekit.permissions import PermissionClient
 from scalekit.connected_accounts import ConnectedAccountsClient
 from scalekit.tools import ToolsClient
-from scalekit.connect import ConnectClient
+from scalekit.actions import ActionClient
 from scalekit.passwordless import PasswordlessClient
 from scalekit.mcp import McpClient
+from scalekit.sessions import SessionsClient
 from scalekit.common.scalekit import (
     AuthorizationUrlOptions,
     CodeAuthenticationOptions,
@@ -66,11 +68,14 @@ class ScalekitClient:
             self.m2m_client = M2MClient(self.core_client)
             self.users = UserClient(self.core_client)
             self.roles = RoleClient(self.core_client)
+            self.permissions = PermissionClient(self.core_client)
             self.connected_accounts = ConnectedAccountsClient(self.core_client)
             self.tools = ToolsClient(self.core_client)
             self.mcp = McpClient(self.core_client)
-            self.connect = ConnectClient(self.tools, self.connected_accounts, self.mcp)
+            self.connect = ActionClient(self.tools, self.connected_accounts, self.mcp)
+            self.actions = ActionClient(self.tools, self.connected_accounts, self.mcp)
             self.passwordless = PasswordlessClient(self.core_client)
+            self.sessions = SessionsClient(self.core_client)
         except Exception as exp:
             raise exp
 

{scalekit_sdk_python-2.4.1 → scalekit_sdk_python-2.4.3}/scalekit/core.py

@@ -26,7 +26,7 @@ class WithCall(Protocol):
 class CoreClient:
     """Class definition for Core Client"""
 
-    sdk_version = "Scalekit-Python/2.4.1"
+    sdk_version = "Scalekit-Python/2.4.3"
     api_version = "20250901"
     user_agent = f"{sdk_version} Python/{platform.python_version()} ({platform.system()}; {platform.architecture()}"