codemie-sdk-python 0.1.703__tar.gz → 0.1.705__tar.gz

{codemie_sdk_python-0.1.703 → codemie_sdk_python-0.1.705}/PKG-INFO

@@ -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 → codemie_sdk_python-0.1.705}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "codemie-sdk-python"
-version = "0.1.703"
+version = "0.1.705"
 description = "CodeMie SDK for Python"
 authors = ["CodeMie"]
 license = "Apache-2.0"

{codemie_sdk_python-0.1.703 → codemie_sdk_python-0.1.705}/src/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_python-0.1.703 → codemie_sdk_python-0.1.705}/src/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_python-0.1.703 → codemie_sdk_python-0.1.705}/src/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_python-0.1.705/src/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_python-0.1.703 → codemie_sdk_python-0.1.705}/src/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_python-0.1.705/src/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,
+        )