kubiya-control-plane-api 0.9.15__py3-none-any.whl

control_plane_api/app/routers/workflows.py

@@ -0,0 +1,204 @@
+from fastapi import APIRouter, Depends, HTTPException, status
+from sqlalchemy.orm import Session
+from typing import List
+from datetime import datetime
+
+from control_plane_api.app.database import get_db
+from control_plane_api.app.models.workflow import Workflow, WorkflowStatus
+from pydantic import BaseModel, Field
+
+router = APIRouter()
+
+
+# Pydantic schemas
+class WorkflowCreate(BaseModel):
+    name: str = Field(..., description="Workflow name")
+    description: str | None = Field(None, description="Workflow description")
+    steps: list = Field(default_factory=list, description="Workflow steps")
+    configuration: dict = Field(default_factory=dict, description="Workflow configuration")
+    team_id: str | None = Field(None, description="Team ID")
+
+
+class WorkflowUpdate(BaseModel):
+    name: str | None = None
+    description: str | None = None
+    status: WorkflowStatus | None = None
+    steps: list | None = None
+    current_step: str | None = None
+    configuration: dict | None = None
+    state: dict | None = None
+
+
+class WorkflowResponse(BaseModel):
+    id: str
+    name: str
+    description: str | None
+    status: WorkflowStatus
+    steps: list
+    current_step: str | None
+    configuration: dict
+    team_id: str | None
+    created_at: datetime
+    updated_at: datetime
+    started_at: datetime | None
+    completed_at: datetime | None
+    state: dict
+    error_message: str | None
+
+    class Config:
+        from_attributes = True
+
+
+@router.post("", response_model=WorkflowResponse, status_code=status.HTTP_201_CREATED)
+def create_workflow(workflow_data: WorkflowCreate, db: Session = Depends(get_db)):
+    """Create a new workflow"""
+    workflow = Workflow(
+        name=workflow_data.name,
+        description=workflow_data.description,
+        steps=workflow_data.steps,
+        configuration=workflow_data.configuration,
+        team_id=workflow_data.team_id,
+    )
+    db.add(workflow)
+    db.commit()
+    db.refresh(workflow)
+    return workflow
+
+
+@router.get("", response_model=List[WorkflowResponse])
+def list_workflows(
+    skip: int = 0,
+    limit: int = 100,
+    status_filter: WorkflowStatus | None = None,
+    team_id: str | None = None,
+    db: Session = Depends(get_db),
+):
+    """List all workflows"""
+    query = db.query(Workflow)
+    if status_filter:
+        query = query.filter(Workflow.status == status_filter)
+    if team_id:
+        query = query.filter(Workflow.team_id == team_id)
+    workflows = query.offset(skip).limit(limit).all()
+    return workflows
+
+
+@router.get("/{workflow_id}", response_model=WorkflowResponse)
+def get_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Get a specific workflow by ID"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+    return workflow
+
+
+@router.patch("/{workflow_id}", response_model=WorkflowResponse)
+def update_workflow(workflow_id: str, workflow_data: WorkflowUpdate, db: Session = Depends(get_db)):
+    """Update a workflow"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    update_data = workflow_data.model_dump(exclude_unset=True)
+    for field, value in update_data.items():
+        setattr(workflow, field, value)
+
+    workflow.updated_at = datetime.utcnow()
+    db.commit()
+    db.refresh(workflow)
+    return workflow
+
+
+@router.delete("/{workflow_id}", status_code=status.HTTP_204_NO_CONTENT)
+def delete_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Delete a workflow"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    db.delete(workflow)
+    db.commit()
+    return None
+
+
+@router.post("/{workflow_id}/start", response_model=WorkflowResponse)
+def start_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Start a workflow"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    if workflow.status == WorkflowStatus.RUNNING:
+        raise HTTPException(status_code=400, detail="Workflow is already running")
+
+    workflow.status = WorkflowStatus.RUNNING
+    workflow.started_at = datetime.utcnow()
+    workflow.error_message = None
+    if workflow.steps and len(workflow.steps) > 0:
+        workflow.current_step = workflow.steps[0].get("id", workflow.steps[0].get("name"))
+    db.commit()
+    db.refresh(workflow)
+    return workflow
+
+
+@router.post("/{workflow_id}/pause", response_model=WorkflowResponse)
+def pause_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Pause a workflow"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    if workflow.status != WorkflowStatus.RUNNING:
+        raise HTTPException(status_code=400, detail="Can only pause running workflows")
+
+    workflow.status = WorkflowStatus.PAUSED
+    db.commit()
+    db.refresh(workflow)
+    return workflow
+
+
+@router.post("/{workflow_id}/resume", response_model=WorkflowResponse)
+def resume_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Resume a paused workflow"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    if workflow.status != WorkflowStatus.PAUSED:
+        raise HTTPException(status_code=400, detail="Can only resume paused workflows")
+
+    workflow.status = WorkflowStatus.RUNNING
+    db.commit()
+    db.refresh(workflow)
+    return workflow
+
+
+@router.post("/{workflow_id}/cancel", response_model=WorkflowResponse)
+def cancel_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Cancel a workflow"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    if workflow.status in [WorkflowStatus.COMPLETED, WorkflowStatus.CANCELLED]:
+        raise HTTPException(status_code=400, detail="Workflow is already completed or cancelled")
+
+    workflow.status = WorkflowStatus.CANCELLED
+    workflow.completed_at = datetime.utcnow()
+    db.commit()
+    db.refresh(workflow)
+    return workflow
+
+
+@router.post("/{workflow_id}/complete", response_model=WorkflowResponse)
+def complete_workflow(workflow_id: str, db: Session = Depends(get_db)):
+    """Mark a workflow as completed"""
+    workflow = db.query(Workflow).filter(Workflow.id == workflow_id).first()
+    if not workflow:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    workflow.status = WorkflowStatus.COMPLETED
+    workflow.completed_at = datetime.utcnow()
+    db.commit()
+    db.refresh(workflow)
+    return workflow

control_plane_api/app/runtimes/__init__.py

@@ -0,0 +1,6 @@
+"""
+Shared runtime validation and configuration.
+
+This module is shared between the API and worker to ensure consistent
+validation logic across both components.
+"""

control_plane_api/app/runtimes/validation.py

@@ -0,0 +1,344 @@
+"""
+Runtime validation system with model compatibility and requirements checking.
+
+This module provides:
+- Model compatibility validation per runtime
+- Runtime requirements specification
+- Agent/Team configuration validation
+- End-to-end validation before execution
+
+This is shared between the API and worker for consistent validation.
+"""
+
+from typing import List, Optional, Dict, Any, Set
+from dataclasses import dataclass
+from enum import Enum
+import re
+
+
+class RuntimeType(str, Enum):
+    """Agent runtime type enumeration"""
+    DEFAULT = "default"  # Agno-based runtime
+    CLAUDE_CODE = "claude_code"  # Claude Code SDK runtime
+
+
+class ValidationError(Exception):
+    """Raised when validation fails."""
+
+    def __init__(self, message: str, field: Optional[str] = None, details: Optional[Dict[str, Any]] = None):
+        self.message = message
+        self.field = field
+        self.details = details or {}
+        super().__init__(message)
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dict for API responses."""
+        result = {"error": self.message}
+        if self.field:
+            result["field"] = self.field
+        if self.details:
+            result["details"] = self.details
+        return result
+
+
+@dataclass
+class ModelRequirement:
+    """Model requirement specification for a runtime."""
+
+    # Patterns that model IDs must match (any match is valid)
+    model_id_patterns: List[str]
+
+    # Model providers that are supported (e.g., "anthropic", "openai")
+    supported_providers: Set[str]
+
+    # Specific model families supported (e.g., "claude", "gpt")
+    supported_families: Set[str]
+
+    # Minimum model version (if applicable)
+    min_version: Optional[str] = None
+
+    # Human-readable description
+    description: str = ""
+
+    # Examples of valid model IDs
+    examples: List[str] = None
+
+    def __post_init__(self):
+        if self.examples is None:
+            self.examples = []
+
+    def validate(self, model_id: Optional[str]) -> tuple[bool, Optional[str]]:
+        """
+        Validate a model ID against this requirement.
+
+        Args:
+            model_id: Model ID to validate
+
+        Returns:
+            Tuple of (is_valid, error_message)
+        """
+        if not model_id:
+            return False, "Model ID is required for this runtime"
+
+        # Check pattern matching
+        for pattern in self.model_id_patterns:
+            if re.search(pattern, model_id, re.IGNORECASE):
+                return True, None
+
+        # Check provider/family
+        model_lower = model_id.lower()
+
+        # Check if any supported family is in the model ID
+        for family in self.supported_families:
+            if family.lower() in model_lower:
+                return True, None
+
+        # Provide helpful error message
+        examples_str = ", ".join(self.examples) if self.examples else "N/A"
+        return False, (
+            f"Model '{model_id}' is not compatible with this runtime. "
+            f"Expected models matching: {', '.join(self.model_id_patterns)}. "
+            f"Supported families: {', '.join(self.supported_families)}. "
+            f"Examples: {examples_str}"
+        )
+
+
+@dataclass
+class RuntimeRequirements:
+    """Requirements specification for a runtime."""
+
+    runtime_type: RuntimeType
+
+    # Model requirements
+    model_requirement: ModelRequirement
+
+    # Required fields in agent/team config
+    required_config_fields: List[str] = None
+
+    # Optional but recommended fields
+    recommended_config_fields: List[str] = None
+
+    # Maximum conversation history length
+    max_history_length: Optional[int] = None
+
+    # Whether system prompt is required
+    requires_system_prompt: bool = False
+
+    # Whether tools/skills are required
+    requires_tools: bool = False
+
+    def __post_init__(self):
+        if self.required_config_fields is None:
+            self.required_config_fields = []
+        if self.recommended_config_fields is None:
+            self.recommended_config_fields = []
+
+    def validate_model(self, model_id: Optional[str]) -> tuple[bool, Optional[str]]:
+        """Validate model compatibility."""
+        return self.model_requirement.validate(model_id)
+
+    def validate_config(self, config: Optional[Dict[str, Any]]) -> List[str]:
+        """
+        Validate agent/team configuration.
+
+        Returns:
+            List of validation errors (empty if valid)
+        """
+        errors = []
+
+        if not config:
+            if self.required_config_fields:
+                errors.append(
+                    f"Configuration is required for this runtime. "
+                    f"Required fields: {', '.join(self.required_config_fields)}"
+                )
+            return errors
+
+        # Check required fields
+        for field in self.required_config_fields:
+            if field not in config or config[field] is None:
+                errors.append(f"Required field '{field}' is missing in configuration")
+
+        return errors
+
+
+class RuntimeRequirementsRegistry:
+    """Registry of runtime requirements for validation."""
+
+    _requirements: Dict[RuntimeType, RuntimeRequirements] = {}
+
+    @classmethod
+    def register(cls, requirements: RuntimeRequirements):
+        """Register requirements for a runtime type."""
+        cls._requirements[requirements.runtime_type] = requirements
+
+    @classmethod
+    def get(cls, runtime_type: RuntimeType) -> Optional[RuntimeRequirements]:
+        """Get requirements for a runtime type."""
+        return cls._requirements.get(runtime_type)
+
+
+# ==================== Default Runtime Requirements ====================
+
+# Agno/Default Runtime - Flexible, supports most models
+DEFAULT_RUNTIME_REQUIREMENTS = RuntimeRequirements(
+    runtime_type=RuntimeType.DEFAULT,
+    model_requirement=ModelRequirement(
+        model_id_patterns=[
+            r".*",  # Accept all models
+        ],
+        supported_providers={"openai", "anthropic", "azure", "google", "mistral", "cohere"},
+        supported_families={"gpt", "claude", "gemini", "mistral", "command"},
+        description="Default runtime supports most LiteLLM-compatible models",
+        examples=[
+            "gpt-4",
+            "gpt-4-turbo",
+            "gpt-3.5-turbo",
+            "claude-3-opus",
+            "claude-3-sonnet",
+            "gemini-pro",
+            "mistral-large",
+        ],
+    ),
+    max_history_length=100,  # Reasonable default
+    requires_system_prompt=False,
+    requires_tools=False,
+)
+
+# Claude Code Runtime - Requires Claude models
+CLAUDE_CODE_RUNTIME_REQUIREMENTS = RuntimeRequirements(
+    runtime_type=RuntimeType.CLAUDE_CODE,
+    model_requirement=ModelRequirement(
+        model_id_patterns=[
+            r"claude",  # Must contain "claude"
+            r"kubiya/claude",  # LiteLLM proxy format
+            r"anthropic\.claude",  # Alternative format
+        ],
+        supported_providers={"anthropic"},
+        supported_families={"claude"},
+        description=(
+            "Claude Code runtime requires Anthropic Claude models. "
+            "This runtime leverages Claude's advanced capabilities including "
+            "extended context, tool use, and code understanding."
+        ),
+        examples=[
+            "claude-3-opus-20240229",
+            "claude-3-sonnet-20240229",
+            "claude-3-5-sonnet-20241022",
+            "claude-3-haiku-20240307",
+            "claude-sonnet-4",
+            "claude-opus-4",
+            "kubiya/claude-sonnet-4",
+            "kubiya/claude-opus-4",
+        ],
+    ),
+    max_history_length=200,  # Claude handles longer contexts well
+    requires_system_prompt=False,  # Optional but recommended
+    requires_tools=False,  # Claude Code adds tools automatically
+    recommended_config_fields=["timeout", "max_tokens"],
+)
+
+
+# Register default requirements
+RuntimeRequirementsRegistry.register(DEFAULT_RUNTIME_REQUIREMENTS)
+RuntimeRequirementsRegistry.register(CLAUDE_CODE_RUNTIME_REQUIREMENTS)
+
+
+# ==================== Validation Helpers ====================
+
+def validate_agent_for_runtime(
+    runtime_type: str,
+    model_id: Optional[str],
+    agent_config: Optional[Dict[str, Any]] = None,
+    system_prompt: Optional[str] = None,
+) -> tuple[bool, List[str]]:
+    """
+    Validate agent configuration for a runtime (for API validation).
+
+    Args:
+        runtime_type: Runtime type string
+        model_id: Model ID to validate
+        agent_config: Agent configuration dict
+        system_prompt: System prompt
+
+    Returns:
+        Tuple of (is_valid, error_messages)
+    """
+    try:
+        rt = RuntimeType(runtime_type)
+    except ValueError:
+        return False, [f"Invalid runtime type: {runtime_type}"]
+
+    requirements = RuntimeRequirementsRegistry.get(rt)
+    if not requirements:
+        # No requirements - allow
+        return True, []
+
+    errors = []
+
+    # Validate model
+    is_valid, error = requirements.validate_model(model_id)
+    if not is_valid:
+        errors.append(error)
+
+    # Validate config
+    config_errors = requirements.validate_config(agent_config)
+    errors.extend(config_errors)
+
+    # Validate system prompt if required
+    if requirements.requires_system_prompt and not system_prompt:
+        errors.append("System prompt is required for this runtime")
+
+    return len(errors) == 0, errors
+
+
+def get_runtime_requirements_info(runtime_type: str) -> Dict[str, Any]:
+    """
+    Get human-readable requirements info for a runtime.
+
+    Args:
+        runtime_type: Runtime type string
+
+    Returns:
+        Dict with requirements information
+    """
+    try:
+        rt = RuntimeType(runtime_type)
+    except ValueError:
+        return {"error": f"Invalid runtime type: {runtime_type}"}
+
+    requirements = RuntimeRequirementsRegistry.get(rt)
+    if not requirements:
+        return {
+            "runtime_type": runtime_type,
+            "model_requirement": "No specific requirements",
+            "flexible": True,
+        }
+
+    return {
+        "runtime_type": runtime_type,
+        "model_requirement": {
+            "description": requirements.model_requirement.description,
+            "supported_providers": list(requirements.model_requirement.supported_providers),
+            "supported_families": list(requirements.model_requirement.supported_families),
+            "examples": requirements.model_requirement.examples,
+        },
+        "required_config_fields": requirements.required_config_fields,
+        "recommended_config_fields": requirements.recommended_config_fields,
+        "max_history_length": requirements.max_history_length,
+        "requires_system_prompt": requirements.requires_system_prompt,
+        "requires_tools": requirements.requires_tools,
+    }
+
+
+def list_all_runtime_requirements() -> Dict[str, Dict[str, Any]]:
+    """
+    Get requirements for all registered runtimes.
+
+    Returns:
+        Dict mapping runtime type to requirements info
+    """
+    return {
+        rt.value: get_runtime_requirements_info(rt.value)
+        for rt in RuntimeRequirementsRegistry._requirements.keys()
+    }

control_plane_api/app/schemas/__init__.py

@@ -0,0 +1 @@
+"""Pydantic schemas for API request/response models."""