codemie-sdk-python 0.1.697__py3-none-any.whl → 0.1.699__py3-none-any.whl

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/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/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/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/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/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)

{codemie_sdk_python-0.1.697.dist-info → codemie_sdk_python-0.1.699.dist-info}/METADATA

@@ -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.dist-info → codemie_sdk_python-0.1.699.dist-info}/RECORD

@@ -1,4 +1,4 @@
-codemie_sdk/__init__.py,sha256=9pK9aoMg0gpyYA1WqOjxGVMOX0tuRUszLdenKikbDIc,8800
+codemie_sdk/__init__.py,sha256=JW5k_uftXXpJOnR5r5gCGBZqyYXqXfjRQD6nqRcUfDk,9024
 codemie_sdk/auth/__init__.py,sha256=IksEj223xEZtJ-cQ0AT9L0Bs9psIJ8QNzDXrPTUQ3xQ,126
 codemie_sdk/auth/credentials.py,sha256=hO0X3EQWZSlIm0ABhiJo4fIIndm2blB0JZWMaWvsuTE,7774
 codemie_sdk/builders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -14,10 +14,10 @@ codemie_sdk/models/a2a.py,sha256=zCNLiwwg78rok04hMlGPcQQS1IbEV4OaMcA_1KxQ9xs,158
 codemie_sdk/models/activity_event.py,sha256=KDEzzUEfs1J9ALNo4mLP-Rq7jeTM4g-P4A5A7Z4YjzM,1072
 codemie_sdk/models/admin.py,sha256=2UGaO60ZrHHcDcV9thYBVxDyUCvtfPQhs10WswhGFJs,2298
 codemie_sdk/models/analytics.py,sha256=B9lLAddL_LylXsoOukiPqbz4HVd2itmuB6iaEbhpKiQ,10194
-codemie_sdk/models/assistant.py,sha256=BkMMIBKA3fibL98PsyEtlIcvZql63oVdI9Pgy9YnemI,22230
+codemie_sdk/models/assistant.py,sha256=0UGqd2hOhcRfCXaSq1c5z3M5MDfYqRQzn_6gDo8URnI,26114
 codemie_sdk/models/categories.py,sha256=eq7_sw-sevNLeWpjaW3N055Xcgbbevs0Bl_rj--maUk,2303
 codemie_sdk/models/common.py,sha256=ipNNdQlv4Ct1UyIAknjJbrdjjvv0lZJYK6dnPm8wai4,1170
-codemie_sdk/models/conversation.py,sha256=qmBn1HnHCr0Flf8Mi-NKn7xOjKgOJKG2iPJFPqa78Sw,10235
+codemie_sdk/models/conversation.py,sha256=r5gV5BD-Euj4OfeLYn6NBiO-S6uFQtwACVobvFgLUcA,10204
 codemie_sdk/models/cost_center.py,sha256=X2hyQ2iewtbG5y9X5qUh1roZ0MJs_i7Vh0Ojh9aut8I,1597
 codemie_sdk/models/datasource.py,sha256=zLA6fwiTKl5H7IDMAlt5LqB2cOI9Cr13D1xU_2EafKs,17012
 codemie_sdk/models/errors.py,sha256=tQXoPUhM2U95NoyTxsSSJws8PQ-Fr3iOQQ8IjJCsx78,11658
@@ -46,12 +46,12 @@ codemie_sdk/services/a2a.py,sha256=JI_heDKmQ1qYGIES_6qPosHRyVb73tKs4v7uTGpzXx4,1
 codemie_sdk/services/activity_event.py,sha256=KoD0DyeqJ0CmQPA4PAXH4uGIAQCgcJbYwDnv-MCckGc,3630
 codemie_sdk/services/admin.py,sha256=yk1xdBXDjpdW4OMOdBaURkZhAxak9h-TppKyhStLekc,4006
 codemie_sdk/services/analytics.py,sha256=wcbbzm9L4YLXy7I054jM8LYlIQnz3gB2K56--OkVT4g,23148
-codemie_sdk/services/assistant.py,sha256=3fHK2cJERgNJJfkvdih0h7bRHdHjlIJHBcS7EcnJ90E,22135
+codemie_sdk/services/assistant.py,sha256=4pgwUXyqego0SUThX2B6FHtsPYmvPzKgr92TEgxAIoA,28835
 codemie_sdk/services/categories.py,sha256=1qd98JCcMNdpbos0O1WpMApT6TurE7OuI7zoYewnwk8,5030
 codemie_sdk/services/codemie_guardrails.py,sha256=O3yCeIQYG8W7z-sVRR4Cw9UVncqP9lPVNxUSaUZrh7I,2833
-codemie_sdk/services/conversation.py,sha256=5vjCjD5C0j7poJE9J2u_ZHS7_E1pjUa2V3XZ1DlbkyA,14841
+codemie_sdk/services/conversation.py,sha256=HWedtlrVXvq4xyAgVNzJ9IZSeHMx4Se5fyp8PPIloEQ,14809
 codemie_sdk/services/cost_center.py,sha256=eybq5DrkHQANegKVbpuLSkiF0J518wDnAGzsweXSQVY,3282
-codemie_sdk/services/customer_config_service.py,sha256=p1bfFCrIWbxT33ItZc7HDd7fvT0tJhESEH2-qZSz8iQ,4883
+codemie_sdk/services/customer_config_service.py,sha256=XxPjiR9cf5M8qjHuRfovwiEAEk7OERJHLTuCAfBr7BU,4871
 codemie_sdk/services/datasource.py,sha256=6kIaHuMzYcrSCaB6_CXemRm2gMPsNxXTQCDxOtRxhDQ,13991
 codemie_sdk/services/dynamic_config.py,sha256=amgSOZ-835r6O_U72sjiFe60rrxJZqJ2L7oKCK-avE4,4214
 codemie_sdk/services/files.py,sha256=ERb6irexO2hIKepUiTw498J0dt0427YNdKrXdcOu9tM,2762
@@ -76,6 +76,6 @@ codemie_sdk/services/workflow_execution_state.py,sha256=u1xmGvaHjqvQS5ujhyvJ_Ac7
 codemie_sdk/services/workspace.py,sha256=eLwZ0fhi1BfOesrXaQlTdOll8q7ENP9b_jb5eybKSVw,5038
 codemie_sdk/utils/__init__.py,sha256=EzK_UrS5KHmAnE73Hci9LaObB5omjVUhIq4svh0gfwo,137
 codemie_sdk/utils/http.py,sha256=PWejBKa5pwzQ5eLVhdN8lYKEu1B1QtwGTRmZfnGFL6c,14158
-codemie_sdk_python-0.1.697.dist-info/METADATA,sha256=WekorKHo4Ptj_W2M9zuRUtOh1Jh7J_XqPu7zKNpk4V0,47441
-codemie_sdk_python-0.1.697.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-codemie_sdk_python-0.1.697.dist-info/RECORD,,
+codemie_sdk_python-0.1.699.dist-info/METADATA,sha256=TN0wXA-aqcBq4G_4gFBll6v8nEoNPdOmzpSYvyPtYtc,47938
+codemie_sdk_python-0.1.699.dist-info/WHEEL,sha256=L-WvLdSBvJWHXv5zrQxDvNRnIgoBzLUpcbuiw19KCuQ,88
+codemie_sdk_python-0.1.699.dist-info/RECORD,,

{codemie_sdk_python-0.1.697.dist-info → codemie_sdk_python-0.1.699.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.5.0
 Root-Is-Purelib: true
 Tag: py3-none-any