codemie-sdk-python 0.1.92__py3-none-any.whl → 0.1.258__py3-none-any.whl

codemie_sdk/services/vendor_workflow.py

@@ -0,0 +1,330 @@
+"""Vendor workflow service implementation for managing cloud vendor workflow settings."""
+
+from typing import Union, Optional, List
+
+from ..models.vendor_assistant import VendorType
+from ..models.vendor_workflow import (
+    VendorWorkflowSettingsResponse,
+    VendorWorkflowsResponse,
+    VendorWorkflow,
+    VendorWorkflowAliasesResponse,
+    VendorWorkflowInstallRequest,
+    VendorWorkflowInstallResponse,
+    VendorWorkflowUninstallResponse,
+)
+from ..utils import ApiRequestHandler
+
+
+class VendorWorkflowService:
+    """Service for managing cloud vendor workflow settings (AWS, Azure, GCP)."""
+
+    def __init__(self, api_domain: str, token: str, verify_ssl: bool = True):
+        """Initialize the vendor workflow service.
+
+        Args:
+            api_domain: Base URL for the CodeMie API
+            token: Authentication token
+            verify_ssl: Whether to verify SSL certificates
+        """
+        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
+
+    def get_workflow_settings(
+        self,
+        vendor: Union[VendorType, str],
+        page: int = 0,
+        per_page: int = 10,
+    ) -> VendorWorkflowSettingsResponse:
+        """Get workflow settings for a specific cloud vendor.
+
+        Args:
+            vendor: Cloud vendor type (aws, azure, gcp). Can be VendorType enum or string.
+            page: Page number for pagination (0-based)
+            per_page: Number of items per page
+
+        Returns:
+            VendorWorkflowSettingsResponse containing list of settings and pagination info
+
+        Example:
+            >>> # Using enum
+            >>> settings = client.vendor_workflows.get_workflow_settings(VendorType.AWS, page=0, per_page=10)
+            >>> # Using string
+            >>> settings = client.vendor_workflows.get_workflow_settings("aws", page=0, per_page=10)
+            >>> # Access settings data
+            >>> for setting in settings.data:
+            ...     print(f"Setting: {setting.setting_name}, Project: {setting.project}")
+            ...     if setting.invalid:
+            ...         print(f"Error: {setting.error}")
+        """
+        # Convert enum to string value if needed
+        vendor_str = vendor.value if isinstance(vendor, VendorType) else vendor
+
+        params = {
+            "page": page,
+            "per_page": per_page,
+        }
+
+        return self._api.get(
+            f"/v1/vendors/{vendor_str}/workflows/settings",
+            VendorWorkflowSettingsResponse,
+            params=params,
+            wrap_response=False,
+        )
+
+    def get_workflows(
+        self,
+        vendor: Union[VendorType, str],
+        setting_id: str,
+        per_page: int = 10,
+        next_token: Optional[str] = None,
+    ) -> VendorWorkflowsResponse:
+        """Get workflows for a specific vendor setting.
+
+        Args:
+            vendor: Cloud vendor type (aws, azure, gcp). Can be VendorType enum or string.
+            setting_id: ID of the vendor setting to retrieve workflows for
+            per_page: Number of items per page
+            next_token: Token for pagination (optional, for retrieving next page)
+
+        Returns:
+            VendorWorkflowsResponse containing list of workflows and pagination token
+
+        Example:
+            >>> # Get first page
+            >>> workflows = client.vendor_workflows.get_workflows(
+            ...     vendor=VendorType.AWS,
+            ...     setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c",
+            ...     per_page=8
+            ... )
+            >>> # Access workflow data
+            >>> for workflow in workflows.data:
+            ...     print(f"Name: {workflow.name}, Status: {workflow.status}")
+            ...     print(f"Version: {workflow.version}, Description: {workflow.description}")
+            >>> # Get next page if available
+            >>> if workflows.pagination.next_token:
+            ...     next_page = client.vendor_workflows.get_workflows(
+            ...         vendor=VendorType.AWS,
+            ...         setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c",
+            ...         per_page=8,
+            ...         next_token=workflows.pagination.next_token
+            ...     )
+        """
+        # Convert enum to string value if needed
+        vendor_str = vendor.value if isinstance(vendor, VendorType) else vendor
+
+        params = {
+            "setting_id": setting_id,
+            "per_page": per_page,
+        }
+
+        if next_token:
+            params["next_token"] = next_token
+
+        return self._api.get(
+            f"/v1/vendors/{vendor_str}/workflows",
+            VendorWorkflowsResponse,
+            params=params,
+            wrap_response=False,
+        )
+
+    def get_workflow(
+        self,
+        vendor: Union[VendorType, str],
+        workflow_id: str,
+        setting_id: str,
+    ) -> VendorWorkflow:
+        """Get a specific workflow by ID for a vendor setting.
+
+        Args:
+            vendor: Cloud vendor type (aws, azure, gcp). Can be VendorType enum or string.
+            workflow_id: ID of the workflow to retrieve
+            setting_id: ID of the vendor setting
+
+        Returns:
+            VendorWorkflow containing workflow details
+
+        Example:
+            >>> workflow = client.vendor_workflows.get_workflow(
+            ...     vendor=VendorType.AWS,
+            ...     workflow_id="9HXLQ7J9YP",
+            ...     setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c"
+            ... )
+            >>> print(f"Name: {workflow.name}, Status: {workflow.status}")
+            >>> print(f"Version: {workflow.version}, Description: {workflow.description}")
+        """
+        # Convert enum to string value if needed
+        vendor_str = vendor.value if isinstance(vendor, VendorType) else vendor
+
+        params = {
+            "setting_id": setting_id,
+        }
+
+        return self._api.get(
+            f"/v1/vendors/{vendor_str}/workflows/{workflow_id}",
+            VendorWorkflow,
+            params=params,
+            wrap_response=False,
+        )
+
+    def get_workflow_aliases(
+        self,
+        vendor: Union[VendorType, str],
+        workflow_id: str,
+        setting_id: str,
+        per_page: int = 10,
+        next_token: Optional[str] = None,
+    ) -> VendorWorkflowAliasesResponse:
+        """Get aliases for a specific vendor workflow.
+
+        Args:
+            vendor: Cloud vendor type (aws, azure, gcp). Can be VendorType enum or string.
+            workflow_id: ID of the workflow to retrieve aliases for
+            setting_id: ID of the vendor setting
+            per_page: Number of items per page
+            next_token: Token for pagination (optional, for retrieving next page)
+
+        Returns:
+            VendorWorkflowAliasesResponse containing list of aliases and pagination token
+
+        Example:
+            >>> # Get first page of aliases
+            >>> aliases = client.vendor_workflows.get_workflow_aliases(
+            ...     vendor=VendorType.AWS,
+            ...     workflow_id="9HXLQ7J9YP",
+            ...     setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c",
+            ...     per_page=5
+            ... )
+            >>> for alias in aliases.data:
+            ...     print(f"{alias.name} (v{alias.version}): {alias.status}")
+            ...     if alias.aiRunId:
+            ...         print(f"  AI Run ID: {alias.aiRunId}")
+            >>> # Get next page if available
+            >>> if aliases.pagination.next_token:
+            ...     next_page = client.vendor_workflows.get_workflow_aliases(
+            ...         vendor=VendorType.AWS,
+            ...         workflow_id="9HXLQ7J9YP",
+            ...         setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c",
+            ...         per_page=5,
+            ...         next_token=aliases.pagination.next_token
+            ...     )
+        """
+        # Convert enum to string value if needed
+        vendor_str = vendor.value if isinstance(vendor, VendorType) else vendor
+
+        params = {
+            "setting_id": setting_id,
+            "per_page": per_page,
+        }
+
+        if next_token:
+            params["next_token"] = next_token
+
+        return self._api.get(
+            f"/v1/vendors/{vendor_str}/workflows/{workflow_id}/aliases",
+            VendorWorkflowAliasesResponse,
+            params=params,
+            wrap_response=False,
+        )
+
+    def install_workflows(
+        self,
+        vendor: Union[VendorType, str],
+        workflows: List[VendorWorkflowInstallRequest],
+    ) -> VendorWorkflowInstallResponse:
+        """Install/activate vendor workflows.
+
+        Args:
+            vendor: Cloud vendor type (aws, azure, gcp). Can be VendorType enum or string.
+            workflows: List of workflow installation requests with workflow ID, flow alias ID, and setting ID
+
+        Returns:
+            VendorWorkflowInstallResponse containing installation summary with AI run IDs
+
+        Example:
+            >>> from codemie_sdk import VendorWorkflowInstallRequest
+            >>> # Install single workflow
+            >>> install_request = VendorWorkflowInstallRequest(
+            ...     id="9HXLQ7J9YP",
+            ...     flowAliasId="9RUV0BI2L7",
+            ...     setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c"
+            ... )
+            >>> response = client.vendor_workflows.install_workflows(
+            ...     vendor=VendorType.AWS,
+            ...     workflows=[install_request]
+            ... )
+            >>> for item in response.summary:
+            ...     print(f"Installed workflow {item.flowId} with run ID: {item.aiRunId}")
+            >>>
+            >>> # Install multiple workflows
+            >>> requests = [
+            ...     VendorWorkflowInstallRequest(
+            ...         id="WORKFLOW_ID_1",
+            ...         flowAliasId="ALIAS_ID_1",
+            ...         setting_id="SETTING_ID"
+            ...     ),
+            ...     VendorWorkflowInstallRequest(
+            ...         id="WORKFLOW_ID_2",
+            ...         flowAliasId="ALIAS_ID_2",
+            ...         setting_id="SETTING_ID"
+            ...     )
+            ... ]
+            >>> response = client.vendor_workflows.install_workflows(
+            ...     vendor=VendorType.AWS,
+            ...     workflows=requests
+            ... )
+        """
+        # Convert enum to string value if needed
+        vendor_str = vendor.value if isinstance(vendor, VendorType) else vendor
+
+        # Convert list of Pydantic models to list of dicts
+        payload = [workflow.model_dump(by_alias=True) for workflow in workflows]
+
+        return self._api.post(
+            f"/v1/vendors/{vendor_str}/workflows",
+            VendorWorkflowInstallResponse,
+            json_data=payload,
+            wrap_response=False,
+        )
+
+    def uninstall_workflow(
+        self,
+        vendor: Union[VendorType, str],
+        ai_run_id: str,
+    ) -> VendorWorkflowUninstallResponse:
+        """Uninstall/deactivate a vendor workflow.
+
+        Args:
+            vendor: Cloud vendor type (aws, azure, gcp). Can be VendorType enum or string.
+            ai_run_id: AI run ID returned from the workflow alias (aiRunId field)
+
+        Returns:
+            VendorWorkflowUninstallResponse with success status
+
+        Example:
+            >>> # Get workflow aliases to find the aiRunId
+            >>> aliases = client.vendor_workflows.get_workflow_aliases(
+            ...     vendor=VendorType.AWS,
+            ...     workflow_id="9HXLQ7J9YP",
+            ...     setting_id="cac90788-39b7-4ffe-8b57-e8b047fa1f6c"
+            ... )
+            >>> # Find an installed alias with aiRunId
+            >>> for alias in aliases.data:
+            ...     if alias.aiRunId:
+            ...         ai_run_id = alias.aiRunId
+            ...         break
+            >>>
+            >>> # Uninstall the workflow using the AI run ID
+            >>> response = client.vendor_workflows.uninstall_workflow(
+            ...     vendor=VendorType.AWS,
+            ...     ai_run_id="56fed66d-f66e-46e3-b420-bb3a8d93eed4"
+            ... )
+            >>> if response.success:
+            ...     print("Workflow successfully uninstalled!")
+        """
+        # Convert enum to string value if needed
+        vendor_str = vendor.value if isinstance(vendor, VendorType) else vendor
+
+        return self._api.delete(
+            f"/v1/vendors/{vendor_str}/workflows/{ai_run_id}",
+            VendorWorkflowUninstallResponse,
+            wrap_response=False,
+        )

codemie_sdk/services/webhook.py

@@ -0,0 +1,41 @@
+import requests
+
+from typing import Dict, Any
+from ..utils import ApiRequestHandler
+
+
+class WebhookService:
+    """Webhook service implementation."""
+
+    def __init__(self, api_domain: str, token: str, verify_ssl: bool = True):
+        """Initialize the conversation service.
+
+        Args:
+            api_domain: Base URL for the API
+            token: Authentication token
+            verify_ssl: Whether to verify SSL certificates
+        """
+        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
+
+    def trigger(
+        self, webhook_id: str, data: Dict[str, Any] = None
+    ) -> requests.Response:
+        """Trigger a webhook by sending a POST request with the provided data.
+
+        Args:
+            webhook_id: Webhook ID to trigger
+            data: Request body data. Defaults to {"test": "data"} if not provided
+
+        Returns:
+            Response object from requests library
+        """
+        if data is None:
+            data = {"test": "data"}
+
+        return self._api.post(
+            f"/v1/webhooks/{webhook_id}",
+            response_model=requests.Response,
+            json_data=data,
+            wrap_response=False,
+            raise_on_error=False,
+        )

codemie_sdk/services/workflow.py

@@ -130,8 +130,32 @@ class WorkflowService:
         """
         return self._api.delete(f"/v1/workflows/{workflow_id}", dict)
 
-    def run(self, workflow_id: str, user_input: str = "") -> dict:
-        return self.executions(workflow_id).create(user_input)
+    def run(
+        self,
+        workflow_id: str,
+        user_input: Optional[str] = None,
+        file_name: Optional[str] = None,
+        propagate_headers: bool = False,
+        headers: Optional[dict[str, str]] = None,
+    ) -> dict:
+        """Run a workflow with optional input parameters.
+
+        Args:
+            workflow_id: ID of the workflow to run
+            user_input: Optional user input for the workflow execution
+            file_name: Optional file name for the workflow execution
+            propagate_headers: Enable propagation of X-* HTTP headers to MCP servers
+            headers: Optional additional HTTP headers (e.g., X-* for MCP propagation)
+
+        Returns:
+            dict: Created workflow execution details
+        """
+        return self.executions(workflow_id).create(
+            user_input=user_input,
+            file_name=file_name,
+            propagate_headers=propagate_headers,
+            headers=headers,
+        )
 
     def executions(self, workflow_id: str) -> WorkflowExecutionService:
         """Get workflow execution service for the specified workflow.

codemie_sdk/services/workflow_execution.py

@@ -4,6 +4,8 @@ from typing import List, Optional
 
 from ..models.common import PaginationParams
 from ..models.workflow import WorkflowExecution
+from ..models.workflow_execution_payload import WorkflowExecutionCreateRequest
+from ..models.workflow_thoughts import WorkflowExecutionThought
 from .workflow_execution_state import WorkflowExecutionStateService
 from ..utils import ApiRequestHandler
 
@@ -43,19 +45,34 @@ class WorkflowExecutionService:
             params=params,
         )
 
-    def create(self, user_input: Optional[str] = "") -> dict:
+    def create(
+        self,
+        user_input: Optional[str] = None,
+        file_name: Optional[str] = None,
+        propagate_headers: bool = False,
+        headers: Optional[dict[str, str]] = None,
+    ) -> dict:
         """Create a new workflow execution.
 
         Args:
             user_input: Optional input data for the workflow execution.
-                       Defaults to None.
+            file_name: Optional file name associated with the workflow execution.
+            propagate_headers: Enable propagation of X-* HTTP headers to MCP servers.
+            headers: Optional additional HTTP headers (e.g., X-* for MCP propagation)
 
         Returns:
             dict: Created workflow execution details
         """
-        payload = {"user_input": user_input}
+        payload = WorkflowExecutionCreateRequest(
+            user_input=user_input,
+            file_name=file_name,
+            propagate_headers=propagate_headers,
+        )
         return self._api.post(
-            f"/v1/workflows/{self._workflow_id}/executions", dict, json_data=payload
+            f"/v1/workflows/{self._workflow_id}/executions",
+            dict,
+            json_data=payload.model_dump(),
+            extra_headers=headers,
         )
 
     def get(self, execution_id: str) -> WorkflowExecution:
@@ -100,15 +117,46 @@ class WorkflowExecutionService:
             f"/v1/workflows/{self._workflow_id}/executions/{execution_id}/abort", dict
         )
 
-    def resume(self, execution_id: str) -> dict:
+    def resume(
+        self,
+        execution_id: str,
+        propagate_headers: bool = False,
+        headers: Optional[dict[str, str]] = None,
+    ) -> dict:
         """Resume an interrupted workflow execution.
 
         Args:
             execution_id: ID of the execution to resume
+            propagate_headers: Enable propagation of X-* HTTP headers to MCP servers.
+            headers: Optional additional HTTP headers (e.g., X-* for MCP propagation)
 
         Returns:
             dict: Updated workflow execution details
         """
+        params = {"propagate_headers": propagate_headers}
+        # Empty body per API; passing empty dict to satisfy typing
         return self._api.put(
-            f"/v1/workflows/{self._workflow_id}/executions/{execution_id}/resume", dict
+            f"/v1/workflows/{self._workflow_id}/executions/{execution_id}/resume",
+            dict,
+            json_data={},
+            params=params,
+            extra_headers=headers,
+        )
+
+    def get_thoughts(
+        self, execution_id: str, thought_ids: List[str]
+    ) -> List[WorkflowExecutionThought]:
+        """Get detailed thoughts information for specific thought IDs.
+
+        Args:
+            execution_id: ID of the execution to get thoughts for
+            thought_ids: List of thought IDs to retrieve detailed information for
+
+        Returns:
+            List[WorkflowExecutionThought]: List of detailed thought objects
+        """
+        return self._api.post(
+            f"/v1/workflows/{self._workflow_id}/executions/{execution_id}/thoughts",
+            List[WorkflowExecutionThought],
+            json_data=thought_ids,
         )

codemie_sdk/utils/http.py

@@ -1,12 +1,11 @@
 """HTTP utilities for CodeMie SDK."""
 
-from typing import TypeVar, Type, Optional, Any, Union, Dict, List, get_origin, get_args
-from pydantic import BaseModel
+from typing import TypeVar, Type, Optional, Any, Dict, List, get_origin, get_args
 import requests
 import logging
 from functools import wraps
 
-T = TypeVar("T", bound=Union[BaseModel, List[BaseModel], dict])
+T = TypeVar("T")
 
 logger = logging.getLogger(__name__)
 
@@ -45,6 +44,19 @@ class ApiRequestHandler:
         self._base_url = base_url.rstrip("/")
         self._token = token
         self._verify_ssl = verify_ssl
+        self._is_localhost = self._is_localhost_domain(base_url)
+
+    @staticmethod
+    def _is_localhost_domain(domain: str) -> bool:
+        """Check if the domain is a localhost variant."""
+        domain_lower = domain.lower()
+        localhost_patterns = [
+            "localhost",
+            "127.0.0.1",
+            "0.0.0.0",
+            "192.168",
+        ]
+        return any(pattern in domain_lower for pattern in localhost_patterns)
 
     def _get_headers(self, exclude_content_type: bool = False) -> dict:
         """Gets request headers with auth token.
@@ -56,14 +68,9 @@ class ApiRequestHandler:
         if not exclude_content_type:
             headers["Content-Type"] = "application/json"
 
-        if (
-            "0.0.0.0" in self._base_url
-            or "127.0.0.1" in self._base_url
-            or "localhost" in self._base_url
-        ):
-            headers["User-Id"] = "dev-codemie-user"
-        else:
-            headers["Authorization"] = f"Bearer {self._token}"
+        headers["Authorization"] = (
+            f"Bearer {self._token}" if not self._is_localhost else "dev-codemie-user"
+        )
         return headers
 
     def _parse_response(
@@ -131,7 +138,7 @@ class ApiRequestHandler:
             wrap_response: Whether response is wrapped in 'data' field
 
         Returns:
-            Parsed response object or list of objects
+            Parsed response object or list of objects, or raw Response if response_model is requests.Response
         """
         if params:
             logger.debug(f"Request params: {params}")
@@ -143,6 +150,9 @@ class ApiRequestHandler:
         )
         response.raise_for_status()
 
+        if response_model is None or response_model is requests.Response:
+            return response
+
         return self._parse_response(response, response_model, wrap_response)
 
     @log_request
@@ -153,7 +163,9 @@ class ApiRequestHandler:
         json_data: Optional[Dict[str, Any]] = None,
         stream: bool = False,
         wrap_response: bool = True,
-    ) -> Union[T, requests.Response]:
+        raise_on_error: bool = True,
+        extra_headers: Optional[Dict[str, str]] = None,
+    ) -> T:
         """Makes a POST request and parses the response.
 
         Args:
@@ -162,6 +174,8 @@ class ApiRequestHandler:
             json_data: JSON request body
             stream: Whether to return streaming response
             wrap_response: Whether response is wrapped in 'data' field
+            raise_on_error: Whether to raise exception on HTTP error status codes
+            extra_headers: Optional additional HTTP headers to include (e.g., X-* for MCP propagation)
 
         Returns:
             Parsed response object/list or streaming response
@@ -169,18 +183,26 @@ class ApiRequestHandler:
         if json_data:
             logger.debug(f"Request body: {json_data}")
 
+        headers = self._get_headers()
+        if extra_headers:
+            headers.update(extra_headers)
+
         response = requests.post(
             url=f"{self._base_url}{endpoint}",
-            headers=self._get_headers(),
+            headers=headers,
             json=json_data,
             verify=self._verify_ssl,
             stream=stream,
         )
-        response.raise_for_status()
+        if raise_on_error:
+            response.raise_for_status()
 
         if stream:
             return response
 
+        if response_model is None or response_model is requests.Response:
+            return response
+
         return self._parse_response(response, response_model, wrap_response)
 
     @log_request
@@ -229,6 +251,7 @@ class ApiRequestHandler:
         json_data: Dict[str, Any],
         params: Optional[Dict[str, Any]] = None,
         wrap_response: bool = True,
+        extra_headers: Optional[Dict[str, str]] = None,
     ) -> T:
         """Makes a PUT request and parses the response.
 
@@ -238,14 +261,18 @@ class ApiRequestHandler:
             json_data: JSON request body
             params: Query parameters
             wrap_response: Whether response is wrapped in 'data' field
+            extra_headers: Optional additional HTTP headers to include (e.g., X-* for MCP propagation)
 
         Returns:
             Parsed response object or list of objects
         """
         logger.debug(f"Request body: {json_data}")
+        headers = self._get_headers()
+        if extra_headers:
+            headers.update(extra_headers)
         response = requests.put(
             url=f"{self._base_url}{endpoint}",
-            headers=self._get_headers(),
+            headers=headers,
             json=json_data,
             params=params,
             verify=self._verify_ssl,