codemie-sdk-python 0.1.703__py3-none-any.whl → 0.1.705__py3-none-any.whl

codemie_sdk/__init__.py

@@ -170,8 +170,8 @@ from .models.integration import (
 from .models.a2a import (
     AgentCard,
     AgentProvider,
+    AgentInterface,
     AgentCapabilities,
-    AgentAuthentication,
     AgentSkill,
 )
 from .services.a2a import A2AService
@@ -307,8 +307,8 @@ __all__ = [
     "TypeOfIntegration",
     "AgentCard",
     "AgentProvider",
+    "AgentInterface",
     "AgentCapabilities",
-    "AgentAuthentication",
     "AgentSkill",
     "A2AService",
 ]

codemie_sdk/client/client.py

@@ -33,6 +33,7 @@ from ..services.mcp_configs import MCPConfigsService
 from ..services.cost_center import CostCenterService
 from ..services.customer_config_service import CustomerConfigService
 from ..services.project_budget_groups import ProjectBudgetGroupsService
+from ..services.servicenow_integration import ServiceNowIntegrationService
 
 
 class CodeMieClient:
@@ -183,6 +184,9 @@ class CodeMieClient:
         self.project_budget_groups = ProjectBudgetGroupsService(
             self._api_domain, _token_source, verify_ssl=self._verify_ssl
         )
+        self.servicenow_integration = ServiceNowIntegrationService(
+            self._api_domain, _token_source, verify_ssl=self._verify_ssl
+        )
         self.a2a = A2AService(
             self._api_domain, _token_source, verify_ssl=self._verify_ssl
         )

codemie_sdk/models/a2a.py

@@ -1,4 +1,6 @@
-"""A2A (agent-to-agent) models."""
+"""A2A (agent-to-agent) models (protocol v1.0)."""
+
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict
 
@@ -8,27 +10,28 @@ class AgentProvider(BaseModel):
 
     model_config = ConfigDict(extra="ignore")
 
-    organization: str
+    organization: str | None = None
     url: str | None = None
 
 
-class AgentCapabilities(BaseModel):
-    """Capabilities advertised by an A2A agent card."""
+class AgentInterface(BaseModel):
+    """A transport interface the agent exposes."""
 
     model_config = ConfigDict(extra="ignore")
 
-    streaming: bool = False
-    pushNotifications: bool = False
-    stateTransitionHistory: bool = False
+    url: str
+    protocolBinding: str | None = None
+    protocolVersion: str | None = None
 
 
-class AgentAuthentication(BaseModel):
-    """Authentication schemes advertised by an A2A agent card."""
+class AgentCapabilities(BaseModel):
+    """Capabilities advertised by an A2A agent card."""
 
     model_config = ConfigDict(extra="ignore")
 
-    schemes: list[str]
-    credentials: str | None = None
+    streaming: bool = False
+    pushNotifications: bool = False
+    extendedAgentCard: bool = False
 
 
 class AgentSkill(BaseModel):
@@ -52,12 +55,20 @@ class AgentCard(BaseModel):
 
     name: str
     description: str | None = None
-    url: str
+    supportedInterfaces: list[AgentInterface]
     provider: AgentProvider | None = None
     version: str
     documentationUrl: str | None = None
     capabilities: AgentCapabilities
-    authentication: AgentAuthentication | None = None
-    defaultInputModes: list[str] = ["text"]
-    defaultOutputModes: list[str] = ["text"]
+    securitySchemes: dict[str, dict[str, Any]] | None = None
+    securityRequirements: list[dict[str, Any]] | None = None
+    defaultInputModes: list[str] = []
+    defaultOutputModes: list[str] = []
     skills: list[AgentSkill]
+
+    @property
+    def protocol_version(self) -> str | None:
+        """Protocol version of the first advertised interface."""
+        if self.supportedInterfaces:
+            return self.supportedInterfaces[0].protocolVersion
+        return None

codemie_sdk/models/servicenow_integration.py

@@ -0,0 +1,103 @@
+# Copyright 2026 EPAM Systems, Inc. ("EPAM")
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""ServiceNow integration models for the CodeMie SDK.
+
+The integration endpoints are callable only by the ServiceNow integration service account.
+The request model is deliberately permissive: the server owns the validation rules, so the
+SDK sends what the caller gives it and surfaces the server's verdict as an HTTP error.
+"""
+
+from enum import Enum
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ServiceNowBudgetAction(str, Enum):
+    """Budget action requested by ServiceNow."""
+
+    SET = "set"
+    ADJUST = "adjust"
+    CANCEL = "cancel"
+
+
+class ServiceNowProject(BaseModel):
+    """A shared project returned by the project lookup."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    project_name: str
+    display_name: str | None = None
+
+
+class ServiceNowBudgetRequest(BaseModel):
+    """Request body for applying a ServiceNow budget request to a project.
+
+    Attributes:
+        action: ``set`` replaces the budget, ``adjust`` merges into it, ``cancel`` deletes it.
+        request_id: ServiceNow request number, used for audit logs and new budget names.
+        epam_project_code: EPAM project code; names the cost center when it differs from
+            the CodeMie project name.
+        codemie_project_name: CodeMie project to manage; the server defaults it to
+            ``epam_project_code`` when omitted.
+        admin_emails: People to make project admins (ignored by ``cancel``).
+        amounts: Monthly budget in USD per category (``platform``, ``cli``,
+            ``premium_models``); required for ``set`` and ``adjust``.
+    """
+
+    # Non-finite amounts are sent as the JSON constants NaN / Infinity instead of null,
+    # so the server, not the client, rejects them.
+    model_config = ConfigDict(ser_json_inf_nan="constants")
+
+    action: ServiceNowBudgetAction
+    request_id: str
+    epam_project_code: str
+    codemie_project_name: str | None = None
+    admin_emails: list[str] = Field(default_factory=list)
+    amounts: dict[str, float] | None = None
+
+
+class ServiceNowBudgetCategory(BaseModel):
+    """Budget of one spend category in a budget response."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    category: str
+    max_budget: float
+    soft_budget: float
+    budget_reset_at: str | None = None
+
+
+class ServiceNowBudgetGroup(BaseModel):
+    """Budget of a project after the request, with its categories in a fixed order."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    total_amount: float
+    budget_duration: str
+    categories: list[ServiceNowBudgetCategory]
+
+
+class ServiceNowBudgetResponse(BaseModel):
+    """Outcome of a budget request."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    project_name: str
+    cost_center: str | None = None
+    created_project: bool
+    created_cost_center: bool
+    budget: ServiceNowBudgetGroup | None = None
+    admins_assigned: list[str] = Field(default_factory=list)
+    admins_pending: list[str] = Field(default_factory=list)

codemie_sdk/services/a2a.py

@@ -27,7 +27,7 @@ class A2AService:
             AgentCard: agent discovery metadata for the assistant
         """
         return self._api.get(
-            f"/v1/a2a/assistants/{assistant_id}/.well-known/agent.json",
+            f"/v1/a2a/assistants/{assistant_id}/.well-known/agent-card.json",
             AgentCard,
             wrap_response=False,
         )

codemie_sdk/services/servicenow_integration.py

@@ -0,0 +1,90 @@
+# Copyright 2026 EPAM Systems, Inc. ("EPAM")
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""ServiceNow integration service for the CodeMie SDK."""
+
+from ..models.servicenow_integration import (
+    ServiceNowBudgetRequest,
+    ServiceNowBudgetResponse,
+    ServiceNowProject,
+)
+from ..utils.http import ApiRequestHandler, TokenSource
+
+
+class ServiceNowIntegrationService:
+    """Service for the ServiceNow integration endpoints.
+
+    Only the ServiceNow integration service account may call these endpoints; any other
+    caller is rejected with HTTP 403.
+    """
+
+    def __init__(self, api_domain: str, token: TokenSource, verify_ssl: bool = True):
+        """Initialize the ServiceNowIntegrationService.
+
+        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 list_projects(self, emails: list[str]) -> list[ServiceNowProject]:
+        """List the shared projects that any of the given users belong to.
+
+        The result is the distinct union across all emails, ordered by project name.
+        Emails with no active CodeMie user are skipped, and an empty list is returned
+        when none match. The emails are sent as given; the server rejects an empty
+        list or an invalid email with HTTP 422.
+
+        Args:
+            emails: Requester and approver emails
+
+        Returns:
+            List of ServiceNowProject with the project name and display name
+
+        Raises:
+            HTTPError: If the request fails
+        """
+        return self._api.get(
+            "/v1/integrations/servicenow/projects",
+            response_model=list[ServiceNowProject],
+            params={"emails": emails},
+            wrap_response=False,
+        )
+
+    def submit_budget_request(
+        self, request: ServiceNowBudgetRequest
+    ) -> ServiceNowBudgetResponse:
+        """Apply a ServiceNow budget request to a project.
+
+        ``set`` replaces the project budget, ``adjust`` merges into it and ``cancel``
+        deletes it. The project (and its cost center) is created when it does not exist,
+        and every resolvable ``admin_emails`` user becomes a project admin.
+
+        Args:
+            request: The budget request
+
+        Returns:
+            ServiceNowBudgetResponse with the resolved project, cost center, the budget
+            after the request (None after cancel) and the admin assignment outcome
+
+        Raises:
+            HTTPError: If the request is rejected (400, 403, 404, 409 or 422)
+        """
+        return self._api.post(
+            "/v1/integrations/servicenow/budgets",
+            response_model=ServiceNowBudgetResponse,
+            data=request.model_dump_json(exclude_none=True),
+            wrap_response=False,
+        )

{codemie_sdk_python-0.1.703.dist-info → codemie_sdk_python-0.1.705.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codemie-sdk-python
-Version: 0.1.703
+Version: 0.1.705
 Summary: CodeMie SDK for Python
 License: Apache-2.0
 Author: CodeMie

{codemie_sdk_python-0.1.703.dist-info → codemie_sdk_python-0.1.705.dist-info}/RECORD

@@ -1,4 +1,4 @@
-codemie_sdk/__init__.py,sha256=JW5k_uftXXpJOnR5r5gCGBZqyYXqXfjRQD6nqRcUfDk,9024
+codemie_sdk/__init__.py,sha256=b3eCiXsjw_q4eubzF97OEDYNJKMq4U98ekRNgvqmcuo,9014
 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
@@ -7,10 +7,10 @@ codemie_sdk/builders/workflow/builder.py,sha256=bb_1uUe0AFhWuqe60Dao_1E-INxPwa7b
 codemie_sdk/builders/workflow/definition.py,sha256=YsKFoYC_VdKsTO2_AobSduP-MGjImEddn_0W5HzPZHQ,14338
 codemie_sdk/builders/workflow/publish.py,sha256=wrXFDNX0LpRTULp8zm5DD6hEmAqEwIMxPm0mSs82xjQ,7370
 codemie_sdk/client/__init__.py,sha256=yf6C39MmrJ6gK9ZHMhBeynKwUUYVSUTQbKxU8-4qpKg,101
-codemie_sdk/client/client.py,sha256=3v4uRF4SGGxR5Rs6fPQRbyysbKI_QEvrTB6wJH3MUN4,9770
+codemie_sdk/client/client.py,sha256=GCTLzF2CPtWI3QPMDerBcQpHuuBx06iQabP4__8SRq0,9996
 codemie_sdk/exceptions.py,sha256=uuzvtvYBMzrNGt7Q4k5RVq0Pd8eJ_tR2tLy3pF2ICDs,1148
 codemie_sdk/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-codemie_sdk/models/a2a.py,sha256=zCNLiwwg78rok04hMlGPcQQS1IbEV4OaMcA_1KxQ9xs,1588
+codemie_sdk/models/a2a.py,sha256=93GGBg4vkrlnuGCtakMLgYtrD9U54Dme9Dm5sJGO2bc,1986
 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
@@ -28,6 +28,7 @@ codemie_sdk/models/llm.py,sha256=ViADvsSAkc85YQyPUkGE3ZvMc5pnHWHO0_rOkLSTfu4,133
 codemie_sdk/models/mcp_config.py,sha256=lqHEYNWW6MhZEx2tMTryVTfq_wThnmMS7vmWxtPkbYM,3792
 codemie_sdk/models/mermaid.py,sha256=dhRgX-itvfyrt0LUg5pbSo0CTH5PewiegqcZn3hWggU,675
 codemie_sdk/models/project.py,sha256=9nMsPNw0mUHud2sAISXrJx2lXz9VKw2Dn-ABq53UgZ8,7600
+codemie_sdk/models/servicenow_integration.py,sha256=xE-QYCaEWsN3znEnw9CkGiRCsAlRzv1SME4rky9k-Y0,3531
 codemie_sdk/models/skill.py,sha256=KE4lsF8TMxIQa_UE0oRDMT6XIEHqKjsDyi0HYKEp1mM,6918
 codemie_sdk/models/task.py,sha256=YHu5DRnECS2wnqIWZ_YH8Z72p1I4aV3xWFW5joxN_8Q,1442
 codemie_sdk/models/user.py,sha256=YqPWzTgIKF-7Jw6aV7RD__su1iahEJPGaDR6Px-B4bU,3848
@@ -42,7 +43,7 @@ codemie_sdk/models/workflow_state.py,sha256=uP1yLYwPpgPc17xpLwjanvlRzK6zT9qMZR-f
 codemie_sdk/models/workflow_thoughts.py,sha256=9fE380lMvC23fq677EI_JTk48Nf2jyPg3-mpj9VTx54,579
 codemie_sdk/models/workflow_transition.py,sha256=axZeiwTo4wzEwZ5GuKphmlRpWmjIuKxV15P_4V1n7LQ,794
 codemie_sdk/models/workspace.py,sha256=xYnVO1Pnd0l0PSBe2pwP80C2ZvYBc2ESo6OH_G0cOOg,1438
-codemie_sdk/services/a2a.py,sha256=JI_heDKmQ1qYGIES_6qPosHRyVb73tKs4v7uTGpzXx4,1026
+codemie_sdk/services/a2a.py,sha256=vxMistimImheSRWWqOP0hy7aiQnv0NjoQnkUchtm73c,1031
 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=yTvBSzDPG2r0BCBukDlnnElvFxLNniyCb8qtYu6foZU,24328
@@ -61,6 +62,7 @@ codemie_sdk/services/mcp_configs.py,sha256=bfe0QTrMqE5hEvyUlNMCjTxqL7u0AG7aZloQr
 codemie_sdk/services/mermaid.py,sha256=7cLykdrJVW576raUbON3yhuWnbGaXl8rX1QfVwbu2JE,2246
 codemie_sdk/services/project.py,sha256=v58ALdLv4BuxMkZNlkNZPikkXcCIePMoQtmKwdKCgko,14703
 codemie_sdk/services/project_budget_groups.py,sha256=B7QJt3sh_LV3lfwALZlxUq0SLR30BWafHcS6eHyOh8Y,5471
+codemie_sdk/services/servicenow_integration.py,sha256=UiMlyiSxegs4gY604rDlKTDxDymKMDP-GRZ85DRlbl8,3376
 codemie_sdk/services/skill.py,sha256=0mExdeKTMNqkEpKafD0ya1WyLj9CMCFaprkggKYqnQg,13216
 codemie_sdk/services/task.py,sha256=UaYh__xGF7VKWCJKPrncVjTvx46Gz1AN9XczPVL71oA,1052
 codemie_sdk/services/user.py,sha256=W0-fkY6vIbJDlIpb2PxxljSMOdWh910BmBK-n94gBs0,6998
@@ -76,6 +78,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.703.dist-info/METADATA,sha256=hem1C48aGo9ij50PNpWpkdjzB4z5OOqJbQXi9NutqIA,47938
-codemie_sdk_python-0.1.703.dist-info/WHEEL,sha256=L-WvLdSBvJWHXv5zrQxDvNRnIgoBzLUpcbuiw19KCuQ,88
-codemie_sdk_python-0.1.703.dist-info/RECORD,,
+codemie_sdk_python-0.1.705.dist-info/METADATA,sha256=8P2ENBdpCaIToRvdEandBFq2_wEeM_qdS5iNQjTVZZE,47938
+codemie_sdk_python-0.1.705.dist-info/WHEEL,sha256=L-WvLdSBvJWHXv5zrQxDvNRnIgoBzLUpcbuiw19KCuQ,88
+codemie_sdk_python-0.1.705.dist-info/RECORD,,