codemie-sdk-python 0.1.697__tar.gz → 0.1.699__tar.gz

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/PKG-INFO

@@ -1,15 +1,22 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: codemie-sdk-python
-Version: 0.1.697
+Version: 0.1.699
 Summary: CodeMie SDK for Python
-Author: Vadym Vlasenko
-Author-email: vadym_vlasenko@epam.com
+License: Apache-2.0
+Author: CodeMie
 Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Requires-Dist: pydantic (>=2.12.2,<3.0.0)
 Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
 Requires-Dist: requests (>=2.31.0,<3.0.0)
+Project-URL: Homepage, https://github.com/codemie-ai/codemie-sdk
+Project-URL: Issues, https://github.com/codemie-ai/codemie-sdk/issues
+Project-URL: Repository, https://github.com/codemie-ai/codemie-sdk
 Description-Content-Type: text/markdown
 
 # CodeMie Python SDK
@@ -87,11 +94,11 @@ from codemie_sdk import CodeMieClient
 
 # Initialize client with authentication parameters
 client = CodeMieClient(
-    auth_server_url="https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
+    auth_server_url="https://your-keycloak-host.example.com/auth",
     auth_client_id="your-client-id",
     auth_client_secret="your-client-secret",
     auth_realm_name="your-realm",
-    codemie_api_domain="https://codemie.lab.epam.com/code-assistant-api"
+    codemie_api_domain="https://your-codemie-host.example.com/code-assistant-api"
 )
 ```
 
@@ -1662,7 +1669,7 @@ client = CodeMieClient(
 
 ## Support
 
-For providing credentials please contact AI/Run CodeMie Team: Vadym_Vlasenko@epam.com or Nikita_Levyankov@epam.com
+For questions and bug reports, open an issue via GitHub Issues. To report a security vulnerability, follow the policy in [SECURITY.md](../../SECURITY.md).
 
 ## Development
 
@@ -1693,7 +1700,6 @@ poetry run ruff format
 # Build package
 poetry build
 # Or make build
-
-# Publish to PyPI
-make publish
 ```
+
+Maintainers publish releases through the release workflow. See [RELEASING.md](../../docs/RELEASING.md).

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/README.md

@@ -73,11 +73,11 @@ from codemie_sdk import CodeMieClient
 
 # Initialize client with authentication parameters
 client = CodeMieClient(
-    auth_server_url="https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
+    auth_server_url="https://your-keycloak-host.example.com/auth",
     auth_client_id="your-client-id",
     auth_client_secret="your-client-secret",
     auth_realm_name="your-realm",
-    codemie_api_domain="https://codemie.lab.epam.com/code-assistant-api"
+    codemie_api_domain="https://your-codemie-host.example.com/code-assistant-api"
 )
 ```
 
@@ -1648,7 +1648,7 @@ client = CodeMieClient(
 
 ## Support
 
-For providing credentials please contact AI/Run CodeMie Team: Vadym_Vlasenko@epam.com or Nikita_Levyankov@epam.com
+For questions and bug reports, open an issue via GitHub Issues. To report a security vulnerability, follow the policy in [SECURITY.md](../../SECURITY.md).
 
 ## Development
 
@@ -1679,7 +1679,6 @@ poetry run ruff format
 # Build package
 poetry build
 # Or make build
+```
 
-# Publish to PyPI
-make publish
-```
+Maintainers publish releases through the release workflow. See [RELEASING.md](../../docs/RELEASING.md).

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/pyproject.toml

@@ -1,15 +1,19 @@
 [tool.poetry]
 name = "codemie-sdk-python"
-version = "0.1.697"
+version = "0.1.699"
 description = "CodeMie SDK for Python"
-authors = [
-    "Vadym Vlasenko <vadym_vlasenko@epam.com>",
-]
+authors = ["CodeMie"]
+license = "Apache-2.0"
+homepage = "https://github.com/codemie-ai/codemie-sdk"
+repository = "https://github.com/codemie-ai/codemie-sdk"
 readme = "README.md"
 packages = [
     { include = "codemie_sdk", from="src"}
 ]
 
+[tool.poetry.urls]
+Issues = "https://github.com/codemie-ai/codemie-sdk/issues"
+
 [tool.poetry.dependencies]
 python = "^3.12"
 requests = "^2.31.0"
@@ -29,7 +33,6 @@ python-gitlab = "^5.6.0"
 boto3 = "^1.39.8"
 aws-assume-role-lib = "^2.10.0"
 codemie-plugins = "^0.1.123"
-pytest-reportportal = "^5.5.2"
 pytest-playwright = "^0.7.0"
 tzlocal = "^5.3.1"
 

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/src/codemie_sdk/__init__.py

@@ -17,6 +17,8 @@ Basic usage:
     >>> assistants = client.assistants.list()
 """
 
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
 from .client.client import CodeMieClient
 from .models.vendor_assistant import (
     VendorType,
@@ -174,7 +176,10 @@ from .models.a2a import (
 )
 from .services.a2a import A2AService
 
-__version__ = "0.2.12"
+try:
+    __version__ = _pkg_version("codemie-sdk-python")
+except PackageNotFoundError:  # running from a source tree that is not installed
+    __version__ = "0+unknown"
 __all__ = [
     "CodeMieClient",
     "VendorType",

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/src/codemie_sdk/models/assistant.py

@@ -456,7 +456,7 @@ class ToolConfig(BaseModel):
         At least one of these fields must be specified for the tool configuration
         to be valid. This ensures that the tool has a way to obtain credentials.
         """
-        if not self.tool_creds and not self.integration_id:
+        if not self.tool_creds and self.integration_id is None:
             raise ValueError("Either tool_creds or integration_id must be provided")
         if self.tool_creds and self.integration_id:
             raise ValueError(
@@ -652,3 +652,111 @@ class ReactionRequest(BaseModel):
     model_config = ConfigDict(extra="ignore", use_enum_values=True)
 
     reaction: ReactionType = Field(description="Reaction type: 'like' or 'dislike'")
+
+
+class AssistantProjectFeature(str, Enum):
+    """Feature discriminator for assistant/project mappings (e.g. Teams bot).
+
+    This enum is expected to grow over time on the backend; treat unrecognized
+    wire values defensively rather than assuming this is the complete set.
+    """
+
+    TEAMS = "teams"
+
+
+class AssistantProjectMappingRequest(BaseModel):
+    """Request body for POST /v1/assistants/{assistant_id}/projects/mapping."""
+
+    model_config = ConfigDict(extra="ignore", use_enum_values=True)
+
+    project_name: str = Field(description="Project (application) name")
+    feature: AssistantProjectFeature = Field(
+        description="Feature discriminator this mapping is for, e.g. 'teams'"
+    )
+
+
+class AssistantProjectMappingPagination(BaseModel):
+    """Pagination metadata returned by GET /v1/assistants/projects/mapping."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    page: int = Field(description="Current page, 0-indexed")
+    per_page: int = Field(description="Items per page")
+    total: int = Field(description="Total matching assistants across all pages")
+
+
+class AssistantProjectMappingListResponse(BaseModel):
+    """Response for GET /v1/assistants/projects/mapping.
+
+    List items are intentionally typed as ``dict[str, Any]`` rather than
+    ``Assistant``/``AssistantBase``. The backend contract documents this
+    endpoint as returning "the same shape as GET /v1/assistants", but that
+    endpoint's own shape is parameterized by a ``minimal_response`` flag that
+    this new endpoint does not expose, and the exact per-item fields returned
+    here are not otherwise confirmed. Rather than guess the wire format,
+    callers get the raw dict and can assert on whichever fields they need
+    (e.g. ``item["id"]``).
+    """
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: list[dict[str, Any]] = Field(default_factory=list)
+    pagination: AssistantProjectMappingPagination
+
+
+class UserMappingSlotConfig(BaseModel):
+    """Configuration for a single integration slot in user mapping."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str = Field(description="Integration slot name (tool name, e.g. 'Git')")
+    integration_id: Optional[str] = Field(
+        default=None,
+        description="Integration ID. None = auto-lookup; empty string = explicit 'no integration'",
+    )
+    auto_lookup: Optional[bool] = Field(
+        default=None,
+        description="Whether auto-credentials lookup is enabled for this slot",
+    )
+    explicit_none: Optional[bool] = Field(
+        default=None,
+        description="User explicitly chose no integration, blocking auto-lookup override",
+    )
+
+
+class UserMappingSaveRequest(BaseModel):
+    """Request body for POST /v1/assistants/{assistant_id}/users/mapping."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    tools_config: List[UserMappingSlotConfig] = Field(
+        default_factory=list,
+        description="Slot configurations to save",
+    )
+    workflow_id: Optional[str] = Field(
+        default=None,
+        description="Workflow scope reference. None = assistant scope",
+    )
+    apply_to_assistant_scope: bool = Field(
+        default=False,
+        description="When True, saves at assistant scope and removes workflow-scoped override",
+    )
+
+
+class UserMappingResponse(BaseModel):
+    """Response body for GET /v1/assistants/{assistant_id}/users/mapping."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    tools_config: List[UserMappingSlotConfig] = Field(
+        default_factory=list,
+        description="Current effective slot configurations",
+    )
+    has_assistant_scope_selection: bool = Field(
+        default=False,
+        description="Whether an assistant-scoped mapping row exists for this user",
+    )
+    workflow_id: Optional[str] = Field(
+        default=None,
+        description="Workflow scope the response is effective for",
+    )

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/src/codemie_sdk/models/conversation.py

@@ -92,7 +92,7 @@ class HistoryItem(BaseModel):
     thoughts: list[Thought] | None = Field(default_factory=list)
     workflowExecutionRef: str | bool | None = None
     executionId: str | None = None
-    # WorkflowExecutionStatusEnum value, e.g. "In Progress" (EPMCDME-14075)
+    # WorkflowExecutionStatusEnum value, e.g. "In Progress"
     executionStatus: str | None = None
 
 
@@ -322,7 +322,7 @@ class AdminConversationListResponse(BaseModel):
     pagination: ConversationPagination
 
 
-# Feedback on assistant messages (EPMCDME-14625)
+# Feedback on assistant messages
 
 
 class FeedbackMark(str, Enum):
@@ -345,7 +345,7 @@ class FeedbackCreateRequest(BaseModel):
 
     ``response`` is required by the backend even though the client already has
     the text elsewhere: omitting it returns a 422 ``response: Field required``
-    error. This was the root cause of EPMCDME-14625, where the frontend built
+    error. This was the root cause of an earlier bug, where the frontend built
     the payload without it and negative feedback could never be submitted.
     Callers must always populate ``response`` -- an empty string is a valid
     value for incomplete, failed, or technical-error assistant responses.

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/src/codemie_sdk/services/assistant.py

@@ -29,8 +29,12 @@ from ..models.assistant import (
     AssistantEvaluationRequest,
     ReactionRequest,
     ToolCallResumeRequest,
+    AssistantProjectFeature,
+    AssistantProjectMappingListResponse,
+    AssistantProjectMappingRequest,
 )
 from ..models.common import PaginationParams
+from ..models.conversation import BaseResponse
 from ..utils import ApiRequestHandler, TokenSource
 
 
@@ -644,3 +648,182 @@ class AssistantService:
             Response from the API
         """
         return self._api.delete(f"/v1/assistants/{assistant_id}/reactions", dict)
+
+    def list_project_mapping(
+        self,
+        project_name: str,
+        feature: AssistantProjectFeature = AssistantProjectFeature.TEAMS,
+        page: int = 0,
+        per_page: int = 12,
+    ) -> AssistantProjectMappingListResponse:
+        """List assistants enabled for a project feature (e.g. Teams bot).
+
+        Accessible to any member of ``project_name``, not just project admins.
+
+        Args:
+            project_name: Project (application) name to list mappings for
+            feature: Feature discriminator, currently only "teams"
+            page: Page number, 0-indexed
+            per_page: Items per page (default 12, max 10000)
+
+        Returns:
+            Paginated list of assistants enabled for the project feature
+        """
+        feature_value = (
+            feature.value if isinstance(feature, AssistantProjectFeature) else feature
+        )
+        params = PaginationParams(page=page, per_page=per_page).to_dict()
+        params["feature"] = feature_value
+        params["project"] = project_name
+        return self._api.get(
+            "/v1/assistants/projects/mapping",
+            AssistantProjectMappingListResponse,
+            params=params,
+            wrap_response=False,
+        )
+
+    def enable_for_project(
+        self,
+        assistant_id: str,
+        project_name: str,
+        feature: AssistantProjectFeature = AssistantProjectFeature.TEAMS,
+    ) -> BaseResponse:
+        """Enable an assistant for a project feature (e.g. Teams bot).
+
+        Idempotent — calling this when the mapping already exists returns 200
+        with no error. Requires the caller to be a project admin/maintainer
+        (or application admin) for ``project_name``.
+
+        Args:
+            assistant_id: ID of the assistant to enable
+            project_name: Project (application) name to enable the mapping for
+            feature: Feature discriminator, currently only "teams"
+
+        Returns:
+            Response confirming the assistant was enabled
+        """
+        request = AssistantProjectMappingRequest(
+            project_name=project_name, feature=feature
+        )
+        return self._api.post(
+            f"/v1/assistants/{assistant_id}/projects/mapping",
+            BaseResponse,
+            json_data=request.model_dump(exclude_none=True),
+        )
+
+    def disable_for_project(
+        self,
+        assistant_id: str,
+        project_name: str,
+        feature: AssistantProjectFeature = AssistantProjectFeature.TEAMS,
+    ) -> BaseResponse:
+        """Disable an assistant for a project feature (e.g. Teams bot).
+
+        Raises an HTTP error (404) if the mapping does not exist. Requires the
+        caller to be a project admin/maintainer (or application admin) for
+        ``project_name``.
+
+        Args:
+            assistant_id: ID of the assistant to disable
+            project_name: Project (application) name to disable the mapping for
+            feature: Feature discriminator, currently only "teams"
+
+        Returns:
+            Response confirming the assistant was disabled
+        """
+        feature_value = (
+            feature.value if isinstance(feature, AssistantProjectFeature) else feature
+        )
+        params = {"project": project_name, "feature": feature_value}
+        return self._api.delete(
+            f"/v1/assistants/{assistant_id}/projects/mapping",
+            BaseResponse,
+            params=params,
+        )
+
+    def get_user_mapping(
+        self,
+        assistant_id: str,
+        workflow_id: Optional[str] = None,
+    ) -> dict:
+        """Get the effective personal integration mapping for an assistant.
+
+        Returns the merged per-slot view following the resolution order:
+        workflow-scoped → assistant-scoped → auto-lookup → none.
+
+        Args:
+            assistant_id: ID of the assistant
+            workflow_id: Optional workflow scope. When provided, returns the effective
+                selection for that workflow; when omitted, returns assistant-scoped only.
+
+        Returns:
+            Mapping response dict with ``tools_config`` list and
+            ``has_assistant_scope_selection`` boolean.
+        """
+        params: dict = {}
+        if workflow_id is not None:
+            params["workflow_id"] = workflow_id
+        return self._api.get(
+            f"/v1/assistants/{assistant_id}/users/mapping",
+            dict,
+            params=params or None,
+        )
+
+    def save_user_mapping(
+        self,
+        assistant_id: str,
+        tools_config: list,
+        workflow_id: Optional[str] = None,
+        apply_to_assistant_scope: bool = False,
+    ) -> dict:
+        """Save personal integration mapping for an assistant.
+
+        When ``workflow_id`` is supplied and ``apply_to_assistant_scope`` is False,
+        a workflow-scoped record is created/updated (the new default on workflow screens).
+        When ``apply_to_assistant_scope`` is True, the mapping is promoted to assistant
+        scope and any existing workflow-scoped override is removed atomically.
+
+        Args:
+            assistant_id: ID of the assistant
+            tools_config: List of slot configuration dicts (each with ``slot_id``
+                and optionally ``integration_id``)
+            workflow_id: Optional workflow scope reference
+            apply_to_assistant_scope: When True, saves at assistant scope
+
+        Returns:
+            Saved mapping response dict
+        """
+        payload: dict = {"tools_config": tools_config}
+        if workflow_id is not None:
+            payload["workflow_id"] = workflow_id
+        if apply_to_assistant_scope:
+            payload["apply_to_assistant_scope"] = True
+        return self._api.post(
+            f"/v1/assistants/{assistant_id}/users/mapping",
+            dict,
+            json_data=payload,
+        )
+
+    def delete_user_mapping(
+        self,
+        assistant_id: str,
+        workflow_id: Optional[str] = None,
+    ) -> dict:
+        """Delete personal integration mapping for an assistant.
+
+        Args:
+            assistant_id: ID of the assistant
+            workflow_id: When provided, deletes the workflow-scoped record only.
+                When omitted, deletes the assistant-scoped record.
+
+        Returns:
+            Response from the API
+        """
+        params: dict = {}
+        if workflow_id is not None:
+            params["workflow_id"] = workflow_id
+        return self._api.delete(
+            f"/v1/assistants/{assistant_id}/users/mapping",
+            dict,
+            params=params or None,
+        )

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/src/codemie_sdk/services/conversation.py

@@ -352,7 +352,7 @@ class ConversationService:
             SharedConversationResponse,
         )
 
-    # Feedback management methods (EPMCDME-14625)
+    # Feedback management methods
 
     def create_feedback(self, request: FeedbackCreateRequest) -> FeedbackCreateResponse:
         """Submit like/dislike feedback on an assistant message.
@@ -385,7 +385,7 @@ class ConversationService:
             json_data=request.model_dump(by_alias=True, exclude_none=True),
         )
 
-    # Conversation finishing (EPMCDME-11067)
+    # Conversation finishing
 
     def finish(self, conversation_id: str) -> ConversationFinishResponse:
         """Mark a conversation as finished (owner-only).

{codemie_sdk_python-0.1.697 → codemie_sdk_python-0.1.699}/src/codemie_sdk/services/customer_config_service.py

@@ -1,6 +1,6 @@
 """Customer config service implementation.
 
-Wraps four endpoints introduced in EPMCDME-13983:
+Wraps four customer-config endpoints:
   GET  /v1/config/declarations            — list dynamic-config declarations (admin/maintainer)
   PUT  /v1/config/declarations/{id}       — save override settings for a component
   DELETE /v1/config/declarations/{id}     — reset component to YAML default (idempotent)