kubiya-control-plane-api 0.3.0__tar.gz

kubiya_control_plane_api-0.3.0/MANIFEST.in

@@ -0,0 +1,42 @@
+# Include documentation
+include README_PYPI.md
+include control_plane_api/README.md
+include control_plane_api/LICENSE
+
+# Include configuration files
+include pyproject.toml
+include control_plane_api/alembic.ini
+include control_plane_api/pytest.ini
+
+# Include executable scripts
+include run_server.py
+include control_plane_api/worker.py
+include build.sh
+
+# Include policy files
+recursive-include control_plane_api/app/policies *.rego
+recursive-include control_plane_api/app/policies *.md
+
+# Include toolset documentation
+recursive-include control_plane_api/app/toolsets *.md
+
+# Include alembic migrations
+recursive-include control_plane_api/alembic *.py
+recursive-include control_plane_api/alembic *.mako
+include control_plane_api/alembic/README
+
+# Exclude compiled Python files
+global-exclude *.py[cod]
+global-exclude __pycache__
+global-exclude *.so
+
+# Exclude test and development files
+recursive-exclude control_plane_api/tests *
+exclude .gitignore
+exclude .dockerignore
+exclude Dockerfile
+exclude docker-compose.yml
+exclude vercel.json
+
+
+

kubiya_control_plane_api-0.3.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: kubiya-control-plane-api
+Version: 0.3.0
+Summary: Agent Control Plane API - Multi-tenant AI agent orchestration and management platform
+Author-email: Kubiya <support@kubiya.ai>
+License-Expression: MIT
+Keywords: ai,agents,orchestration,temporal,fastapi,multi-tenant,workflow,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: <4.0.0,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi<1.0.0,>=0.109.0
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.27.0
+Requires-Dist: sqlalchemy<3.0.0,>=2.0.25
+Requires-Dist: psycopg2-binary<3.0.0,>=2.9.9
+Requires-Dist: pydantic<3.0.0,>=2.5.3
+Requires-Dist: pydantic-settings<3.0.0,>=2.1.0
+Requires-Dist: alembic<2.0.0,>=1.13.1
+Requires-Dist: httpx<1.0.0,>=0.26.0
+Requires-Dist: python-multipart<1.0.0,>=0.0.6
+Requires-Dist: python-jose[cryptography]<4.0.0,>=3.3.0
+Requires-Dist: PyJWT<3.0.0,>=2.8.0
+Requires-Dist: passlib[bcrypt]<2.0.0,>=1.7.4
+Requires-Dist: litellm<2.0.0,>=1.30.0
+Requires-Dist: agno<3.0.0,>=2.0.10
+Requires-Dist: supabase<3.0.0,>=2.3.0
+Requires-Dist: temporalio<2.0.0,>=1.5.0
+Requires-Dist: structlog<25.0.0,>=24.1.0
+Requires-Dist: mangum<1.0.0,>=0.17.0
+Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: nest-asyncio<2.0.0,>=1.5.0
+Requires-Dist: docker<8.0.0,>=7.0.0
+Requires-Dist: redis<6.0.0,>=5.0.0
+Requires-Dist: psutil<6.0.0,>=5.9.0
+Provides-Extra: dev
+Requires-Dist: pytest<9.0.0,>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio<1.0.0,>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov<6.0.0,>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock<4.0.0,>=3.11.0; extra == "dev"
+Requires-Dist: pytest-xdist<4.0.0,>=3.5.0; extra == "dev"
+Requires-Dist: fakeredis<3.0.0,>=2.20.0; extra == "dev"
+Requires-Dist: respx<1.0.0,>=0.20.0; extra == "dev"
+Requires-Dist: black<25.0.0,>=23.0.0; extra == "dev"
+Requires-Dist: ruff<1.0.0,>=0.1.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest<9.0.0,>=7.4.0; extra == "test"
+Requires-Dist: pytest-asyncio<1.0.0,>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov<6.0.0,>=4.1.0; extra == "test"
+Requires-Dist: pytest-mock<4.0.0,>=3.11.0; extra == "test"
+Requires-Dist: pytest-xdist<4.0.0,>=3.5.0; extra == "test"
+Requires-Dist: fakeredis<3.0.0,>=2.20.0; extra == "test"
+Requires-Dist: respx<1.0.0,>=0.20.0; extra == "test"
+Provides-Extra: all
+Requires-Dist: kubiya-control-plane-api[dev,test]; extra == "all"
+
+# Kubiya Control Plane API
+
+Multi-tenant AI agent orchestration and management platform powered by Temporal workflows.
+
+## Installation
+
+### Basic Installation
+
+```bash
+pip install kubiya-control-plane-api
+```
+
+### Installation with Extras
+
+Install with development dependencies:
+
+```bash
+pip install "kubiya-control-plane-api[dev]"
+```
+
+Install with test dependencies:
+
+```bash
+pip install "kubiya-control-plane-api[test]"
+```
+
+Install with all optional dependencies:
+
+```bash
+pip install "kubiya-control-plane-api[all]"
+```
+
+## Running for Development
+
+### 1. Clone the repository
+
+```bash
+git clone https://github.com/kubiyabot/agent-control-plane.git
+cd agent-control-plane
+```
+
+### 2. Set up environment variables
+
+Create a `.env` file with the required variables (see below).
+
+### 3. Build an image and run.
+
+```bash
+make build
+
+make up
+```
+
+The API will be available at `http://localhost:7777/api/docs`
+
+## Running the Worker
+
+The worker processes Temporal workflows for agent execution.
+
+### Using the CLI command
+
+After installing the package, run:
+
+```bash
+kubiya-control-plane-worker
+```
+
+### Using Python module
+
+```bash
+python -m control_plane_api.worker
+```
+
+## Required Environment Variables
+
+The following environment variables **must** be set to run the worker:
+
+### Temporal Configuration (Required)
+
+```bash
+TEMPORAL_HOST=localhost:7233
+TEMPORAL_NAMESPACE=default
+```
+
+- `TEMPORAL_HOST`: Address of your Temporal server
+- `TEMPORAL_NAMESPACE`: Temporal namespace to use
+
+### Database Configuration (Required)
+
+**Option 1: Direct PostgreSQL**
+
+```bash
+DATABASE_URL=postgresql://user:password@localhost:5432/control_plane
+```
+
+**Option 2: Supabase**
+
+```bash
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_SERVICE_KEY=your-service-role-key
+SUPABASE_POSTGRES_URL=postgresql://user:password@host:5432/database
+```
+
+You need **either** `DATABASE_URL` **or** all three Supabase variables.
+
+### Temporal Cloud Authentication (If using Temporal Cloud)
+
+If connecting to Temporal Cloud instead of a self-hosted server, you also need **one** of:
+
+**Option A: API Key**
+
+```bash
+TEMPORAL_API_KEY=your-temporal-cloud-api-key
+```
+
+**Option B: mTLS Certificates**
+
+```bash
+TEMPORAL_CLIENT_CERT_PATH=/path/to/cert.pem
+TEMPORAL_CLIENT_KEY_PATH=/path/to/key.pem
+```
+
+### Quick Start Example
+
+```bash
+# 1. Install the package
+pip install kubiya-control-plane-api
+
+# 2. Set required environment variables
+export TEMPORAL_HOST=localhost:7233
+export TEMPORAL_NAMESPACE=default
+export DATABASE_URL=postgresql://user:password@localhost:5432/control_plane
+
+# 3. Run the worker
+kubiya-control-plane-worker
+```
+
+The worker will connect to Temporal and start processing agent execution workflows.

kubiya_control_plane_api-0.3.0/README_PYPI.md

@@ -0,0 +1,138 @@
+# Kubiya Control Plane API
+
+Multi-tenant AI agent orchestration and management platform powered by Temporal workflows.
+
+## Installation
+
+### Basic Installation
+
+```bash
+pip install kubiya-control-plane-api
+```
+
+### Installation with Extras
+
+Install with development dependencies:
+
+```bash
+pip install "kubiya-control-plane-api[dev]"
+```
+
+Install with test dependencies:
+
+```bash
+pip install "kubiya-control-plane-api[test]"
+```
+
+Install with all optional dependencies:
+
+```bash
+pip install "kubiya-control-plane-api[all]"
+```
+
+## Running for Development
+
+### 1. Clone the repository
+
+```bash
+git clone https://github.com/kubiyabot/agent-control-plane.git
+cd agent-control-plane
+```
+
+### 2. Set up environment variables
+
+Create a `.env` file with the required variables (see below).
+
+### 3. Build an image and run.
+
+```bash
+make build
+
+make up
+```
+
+The API will be available at `http://localhost:7777/api/docs`
+
+## Running the Worker
+
+The worker processes Temporal workflows for agent execution.
+
+### Using the CLI command
+
+After installing the package, run:
+
+```bash
+kubiya-control-plane-worker
+```
+
+### Using Python module
+
+```bash
+python -m control_plane_api.worker
+```
+
+## Required Environment Variables
+
+The following environment variables **must** be set to run the worker:
+
+### Temporal Configuration (Required)
+
+```bash
+TEMPORAL_HOST=localhost:7233
+TEMPORAL_NAMESPACE=default
+```
+
+- `TEMPORAL_HOST`: Address of your Temporal server
+- `TEMPORAL_NAMESPACE`: Temporal namespace to use
+
+### Database Configuration (Required)
+
+**Option 1: Direct PostgreSQL**
+
+```bash
+DATABASE_URL=postgresql://user:password@localhost:5432/control_plane
+```
+
+**Option 2: Supabase**
+
+```bash
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_SERVICE_KEY=your-service-role-key
+SUPABASE_POSTGRES_URL=postgresql://user:password@host:5432/database
+```
+
+You need **either** `DATABASE_URL` **or** all three Supabase variables.
+
+### Temporal Cloud Authentication (If using Temporal Cloud)
+
+If connecting to Temporal Cloud instead of a self-hosted server, you also need **one** of:
+
+**Option A: API Key**
+
+```bash
+TEMPORAL_API_KEY=your-temporal-cloud-api-key
+```
+
+**Option B: mTLS Certificates**
+
+```bash
+TEMPORAL_CLIENT_CERT_PATH=/path/to/cert.pem
+TEMPORAL_CLIENT_KEY_PATH=/path/to/key.pem
+```
+
+### Quick Start Example
+
+```bash
+# 1. Install the package
+pip install kubiya-control-plane-api
+
+# 2. Set required environment variables
+export TEMPORAL_HOST=localhost:7233
+export TEMPORAL_NAMESPACE=default
+export DATABASE_URL=postgresql://user:password@localhost:5432/control_plane
+
+# 3. Run the worker
+kubiya-control-plane-worker
+```
+
+The worker will connect to Temporal and start processing agent execution workflows.

kubiya_control_plane_api-0.3.0/control_plane_api/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Kubiya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

kubiya_control_plane_api-0.3.0/control_plane_api/README.md

@@ -0,0 +1,266 @@
+# Kubiya Control Plane API
+
+A multi-tenant AI agent orchestration and management platform built with FastAPI, Temporal, and PostgreSQL.
+
+## Features
+
+- **Multi-tenant Architecture**: Manage multiple projects, teams, and agents
+- **Workflow Orchestration**: Temporal-based workflow execution
+- **Flexible Agent Runtime**: Support for multiple agent types and toolsets
+- **Policy Enforcement**: OPA-based policy engine for agent governance
+- **Scalable Workers**: Distributed worker architecture for agent execution
+- **Context Management**: Environment and team-specific context handling
+- **LLM Integration**: Support for multiple LLM providers via LiteLLM
+- **Comprehensive APIs**: RESTful APIs for all platform features
+
+## Installation
+
+### Using pip
+
+```bash
+pip install kubiya-control_plane_api
+```
+
+### From source
+
+```bash
+git clone https://github.com/kubiyabot/agent-control-plane.git
+cd agent-control-plane/control_plane_api
+pip install -e .
+```
+
+### With development dependencies
+
+```bash
+pip install kubiya-control_plane_api[dev]
+```
+
+## Quick Start
+
+### 1. Set up environment variables
+
+Create a `.env` file or set the following environment variables:
+
+```bash
+# Database Configuration
+DATABASE_URL=postgresql://user:password@localhost:5432/control_plane
+
+# Supabase (for serverless deployments)
+SUPABASE_URL=your-supabase-url
+SUPABASE_KEY=your-supabase-key
+
+# Temporal Configuration
+TEMPORAL_HOST=localhost:7233
+TEMPORAL_NAMESPACE=default
+
+# API Configuration
+API_TITLE="Agent Control Plane"
+API_VERSION="1.0.0"
+ENVIRONMENT=development
+LOG_LEVEL=info
+
+# Security
+SECRET_KEY=your-secret-key-here
+
+# Optional: Kubiya Integration
+KUBIYA_API_KEY=your-kubiya-api-key
+KUBIYA_API_URL=https://api.kubiya.ai
+```
+
+### 2. Run database migrations
+
+```bash
+alembic upgrade head
+```
+
+### 3. Start the API server
+
+```bash
+uvicorn app.main:app --host 0.0.0.0 --port 7777 --reload
+```
+
+The API will be available at `http://localhost:7777`
+
+### 4. Access the API documentation
+
+Open your browser and navigate to:
+- Swagger UI: `http://localhost:7777/api/docs`
+- ReDoc: `http://localhost:7777/api/redoc`
+
+### 5. Start a worker (optional)
+
+To process agent execution workflows:
+
+```bash
+python worker.py
+```
+
+## Package Structure
+
+```
+app/
+├── activities/          # Temporal activities
+├── lib/                # Client libraries (Kubiya, Redis, Temporal, etc.)
+├── middleware/         # FastAPI middleware (auth, etc.)
+├── models/             # SQLAlchemy models
+├── policies/           # OPA policy files (.rego)
+├── routers/            # FastAPI route handlers
+├── services/           # Business logic services
+├── toolsets/           # Agent toolsets
+├── workflows/          # Temporal workflows
+├── config.py           # Configuration management
+├── database.py         # Database connection
+└── main.py            # FastAPI application entry point
+```
+
+## API Endpoints
+
+### Core Resources
+
+- **Projects**: `/api/v1/projects` - Multi-project management
+- **Environments**: `/api/v1/environments` - Environment configuration
+- **Agents**: `/api/v1/agents` - Agent management
+- **Teams**: `/api/v1/teams` - Team management
+- **Workflows**: `/api/v1/workflows` - Workflow definitions
+- **Executions**: `/api/v1/executions` - Execution tracking
+- **Workers**: `/api/v1/workers` - Worker registration and management
+
+### Toolsets and Policies
+
+- **Toolsets**: `/api/v1/toolsets` - Tool sets and definitions
+- **Policies**: `/api/v1/policies` - Policy management and enforcement
+
+### Integration
+
+- **Secrets**: `/api/v1/secrets` - Secrets management (proxies to Kubiya)
+- **Integrations**: `/api/v1/integrations` - Third-party integrations
+- **Models**: `/api/v1/models` - LLM model configuration
+
+### Utilities
+
+- **Health**: `/api/health` - Health check endpoint
+- **Task Planning**: `/api/v1/task-planning` - AI-powered task planning
+
+## Configuration
+
+The application uses Pydantic Settings for configuration management. All settings can be configured via environment variables or a `.env` file.
+
+### Key Configuration Options
+
+- `DATABASE_URL`: PostgreSQL connection string
+- `SUPABASE_URL`, `SUPABASE_KEY`: Supabase configuration for serverless
+- `TEMPORAL_HOST`: Temporal server address
+- `KUBIYA_API_KEY`: Kubiya platform API key
+- `SECRET_KEY`: Secret key for JWT token signing
+- `LOG_LEVEL`: Logging level (debug, info, warning, error)
+- `ENVIRONMENT`: Deployment environment (development, staging, production)
+
+## Development
+
+### Install development dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+### Run tests
+
+```bash
+# All tests
+pytest
+
+# Unit tests only
+pytest -m unit
+
+# Integration tests
+pytest -m integration
+
+# With coverage
+pytest --cov=app --cov-report=html
+```
+
+### Code formatting
+
+```bash
+# Format code with black
+black .
+
+# Lint with ruff
+ruff check .
+```
+
+### Database migrations
+
+```bash
+# Create a new migration
+alembic revision --autogenerate -m "Description of changes"
+
+# Apply migrations
+alembic upgrade head
+
+# Rollback migration
+alembic downgrade -1
+```
+
+## Deployment
+
+### Docker
+
+```bash
+docker build -t control_plane_api .
+docker run -p 7777:7777 --env-file .env control_plane_api
+```
+
+### Vercel (Serverless)
+
+The API is configured for Vercel deployment with `vercel.json` and the Mangum adapter.
+
+```bash
+vercel deploy
+```
+
+## Architecture
+
+### Workflow Orchestration
+
+The platform uses Temporal for reliable workflow execution:
+- Durable execution with automatic retries
+- Activity-based task decomposition
+- Support for long-running workflows
+- Built-in observability and monitoring
+
+### Multi-tenancy
+
+- **Projects**: Top-level isolation boundary
+- **Environments**: Isolated execution contexts within projects
+- **Teams**: Collaborative agent groups
+- **Agents**: Individual agent instances
+
+### Worker Architecture
+
+Workers pull tasks from environment-specific queues and execute agent workflows using Temporal.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests and linting
+5. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Support
+
+For issues and questions:
+- GitHub Issues: https://github.com/kubiyabot/agent-control-plane/issues
+- Email: support@kubiya.ai
+
+## Links
+
+- [Documentation](https://github.com/kubiyabot/agent-control-plane/blob/main/README.md)
+- [GitHub Repository](https://github.com/kubiyabot/agent-control-plane)
+- [Kubiya Platform](https://kubiya.ai)
+

kubiya_control_plane_api-0.3.0/control_plane_api/__version__.py

@@ -0,0 +1 @@
+__version__ = "v0.3.0"

kubiya_control_plane_api-0.3.0/control_plane_api/alembic/README

@@ -0,0 +1 @@
+Generic single-database configuration.