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

codemie_sdk/__init__.py

@@ -175,6 +175,16 @@ from .models.a2a import (
     AgentSkill,
 )
 from .services.a2a import A2AService
+from .models.usage_attribution import (
+    UsageAttributionQueryParams,
+    UsageAttributionRange,
+    UsageAttributionAnalysisSettings,
+    UsageAttributionAnalysis,
+    UsageAttributionResponse,
+    UsageAttributionTableResponse,
+    UsageAttributionSettingsResponse,
+)
+from .services.usage_attribution import UsageAttributionService
 
 try:
     __version__ = _pkg_version("codemie-sdk-python")
@@ -311,4 +321,12 @@ __all__ = [
     "AgentCapabilities",
     "AgentSkill",
     "A2AService",
+    "UsageAttributionQueryParams",
+    "UsageAttributionRange",
+    "UsageAttributionAnalysisSettings",
+    "UsageAttributionAnalysis",
+    "UsageAttributionResponse",
+    "UsageAttributionTableResponse",
+    "UsageAttributionSettingsResponse",
+    "UsageAttributionService",
 ]

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.usage_attribution import UsageAttributionService
 from ..services.servicenow_integration import ServiceNowIntegrationService
 
 
@@ -193,6 +194,9 @@ class CodeMieClient:
         self.workspaces = WorkspaceService(
             self._api_domain, _token_source, verify_ssl=self._verify_ssl
         )
+        self.usage_attribution = UsageAttributionService(
+            self._api_domain, _token_source, verify_ssl=self._verify_ssl
+        )
 
     @property
     def token(self) -> str:

codemie_sdk/models/usage_attribution.py

@@ -0,0 +1,124 @@
+# 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.
+
+"""Usage Attribution analytics models for the CodeMie SDK."""
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .analytics import PaginationMetadata
+
+
+class UsageAttributionQueryParams(BaseModel):
+    """Period parameters shared by the Usage Attribution read endpoints.
+
+    The endpoints take no project or user filter: they always attribute all usage.
+    """
+
+    model_config = ConfigDict(extra="ignore")
+
+    time_period: str | None = Field(
+        None,
+        description='Time period: "last_hour", "last_6_hours", "last_24_hours", "last_7_days", "last_30_days", "last_60_days", "last_year"',
+    )
+    start_date: str | None = Field(
+        None, description="ISO 8601 start date (use with end_date)"
+    )
+    end_date: str | None = Field(
+        None, description="ISO 8601 end date (use with start_date)"
+    )
+
+
+class UsageAttributionRange(BaseModel):
+    """The effective range of a response; ranges longer than the maximum are clamped."""
+
+    model_config = ConfigDict(extra="ignore", populate_by_name=True)
+
+    from_: str = Field(alias="from", description="Effective start")
+    to: str = Field(description="Effective end")
+    days: float = Field(description="Length of the effective range in days")
+    clamped: bool = Field(description="The requested range was cut to the maximum")
+    requested_from: str | None = Field(None, description="Requested start")
+    requested_to: str | None = Field(None, description="Requested end")
+    evidence_from: str | None = Field(
+        None, description="Start of the evidence window used for categories"
+    )
+
+
+class UsageAttributionAnalysisSettings(BaseModel):
+    """The analysis settings behind a response."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    hash: str | None = None
+    defaults_hash: str | None = None
+    schema_version: int | None = None
+    overridden: list[str] = Field(default_factory=list)
+    tier: str | None = None
+
+
+class UsageAttributionAnalysis(BaseModel):
+    """When and how the cached analysis behind a response was computed."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    computed_at: str | None = None
+    duration_ms: float | None = None
+    cache: str = Field(description="hit, miss, shared or stale")
+    stale: bool = False
+    refreshing: bool = Field(False, description="A newer analysis is being computed")
+    error: str | None = None
+    ttl_s: int | None = None
+    window: dict[str, Any] | None = None
+    evidence_window: dict[str, Any] | None = None
+    coverage: dict[str, Any] | None = None
+    unclassified_reasons: dict[str, Any] | None = None
+    allocated: float | None = None
+    timings: dict[str, Any] = Field(default_factory=dict)
+    settings: UsageAttributionAnalysisSettings | None = None
+
+
+class UsageAttributionResponse(BaseModel):
+    """A composite view: totals, tiles, charts, a popup or How It Works."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: dict[str, Any]
+    range: UsageAttributionRange | None = None
+    analysis: UsageAttributionAnalysis | None = Field(
+        None, description="Absent for the fast totals, which skip the analysis"
+    )
+
+
+class UsageAttributionTableResponse(BaseModel):
+    """A table page: rows of the page, totals over every matching row and filter counts."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: dict[str, Any] = Field(description="rows and totals")
+    pagination: PaginationMetadata
+    counts: dict[str, int] = Field(default_factory=dict)
+    threshold: float | None = None
+    display: dict[str, float] | None = None
+    range: UsageAttributionRange
+    analysis: UsageAttributionAnalysis
+
+
+class UsageAttributionSettingsResponse(BaseModel):
+    """The tunable settings schema, the defaults and whether the caller may tune."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: dict[str, Any]

codemie_sdk/services/usage_attribution.py

@@ -0,0 +1,324 @@
+# 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.
+
+"""Usage Attribution analytics service for the CodeMie SDK.
+
+Wraps the read endpoints under ``/v1/analytics/usage-attribution``, available to
+admins, maintainers and auditors when the ``features:usageAttribution`` flag is on.
+"""
+
+from typing import Any
+from urllib.parse import quote
+
+from ..models.usage_attribution import (
+    UsageAttributionQueryParams,
+    UsageAttributionResponse,
+    UsageAttributionSettingsResponse,
+    UsageAttributionTableResponse,
+)
+from ..utils import ApiRequestHandler, TokenSource
+
+_BASE = "/v1/analytics/usage-attribution"
+
+
+class UsageAttributionService:
+    """Service for reading Usage Attribution analytics: who pays for Web Platform and CLI usage."""
+
+    def __init__(self, api_domain: str, token: TokenSource, verify_ssl: bool = True):
+        """Initialize the usage attribution 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)
+
+    @staticmethod
+    def _query(
+        params: UsageAttributionQueryParams | None, **extra: Any
+    ) -> dict[str, Any]:
+        """Period parameters plus the extra ones that were given (None means the server default)."""
+        query = params.model_dump(exclude_none=True) if params else {}
+        query.update({key: value for key, value in extra.items() if value is not None})
+        return query
+
+    def _get_view(
+        self,
+        path: str,
+        params: UsageAttributionQueryParams | None = None,
+        **extra: Any,
+    ) -> UsageAttributionResponse:
+        return self._api.get(
+            f"{_BASE}{path}",
+            UsageAttributionResponse,
+            params=self._query(params, **extra),
+            wrap_response=False,
+        )
+
+    def _get_table(
+        self,
+        path: str,
+        params: UsageAttributionQueryParams | None = None,
+        **extra: Any,
+    ) -> UsageAttributionTableResponse:
+        return self._api.get(
+            f"{_BASE}{path}",
+            UsageAttributionTableResponse,
+            params=self._query(params, **extra),
+            wrap_response=False,
+        )
+
+    def get_totals(
+        self, params: UsageAttributionQueryParams | None = None
+    ) -> UsageAttributionResponse:
+        """Get the fast totals: Total, Web Platform, CLI, Charged Back and Who Pays.
+
+        Args:
+            params: Period parameters
+
+        Returns:
+            UsageAttributionResponse whose data holds the amounts. The analysis
+            block is absent for this view.
+
+        Raises:
+            requests.HTTPError: 403 without an allowed role, 404 when the feature is off
+        """
+        return self._get_view("/totals", params)
+
+    def get_status(
+        self, params: UsageAttributionQueryParams | None = None
+    ) -> UsageAttributionResponse:
+        """Get How It Works: coverage, data quality, run details and the settings in effect.
+
+        Args:
+            params: Period parameters
+
+        Returns:
+            UsageAttributionResponse with the analysis block
+        """
+        return self._get_view("/status", params)
+
+    def get_cli_summary(
+        self, params: UsageAttributionQueryParams | None = None
+    ) -> UsageAttributionResponse:
+        """Get the CLI categories: tiles, Who Pays and CLI spend by category.
+
+        Args:
+            params: Period parameters
+
+        Returns:
+            UsageAttributionResponse with tiles, who_pays, categories and the analysis block
+        """
+        return self._get_view("/cli-summary", params)
+
+    def get_settings(self) -> UsageAttributionSettingsResponse:
+        """Get the analysis settings: defaults, tunable schema and what the caller may do.
+
+        Returns:
+            UsageAttributionSettingsResponse, whose data carries ``can_tune`` and ``can_refresh``
+        """
+        return self._api.get(
+            f"{_BASE}/settings",
+            UsageAttributionSettingsResponse,
+            wrap_response=False,
+        )
+
+    def get_shared_projects(
+        self,
+        params: UsageAttributionQueryParams | None = None,
+        scope: str | None = None,
+        search: str | None = None,
+        page: int | None = None,
+        per_page: int | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> UsageAttributionTableResponse:
+        """List shared projects without a budget.
+
+        Args:
+            params: Period parameters
+            scope: "threshold" (default) or "all"
+            search: Case-insensitive text to find in the project name
+            page: Zero-indexed page number
+            per_page: Items per page
+            sort_by: Column to sort by
+            sort_order: "asc" or "desc"
+
+        Returns:
+            UsageAttributionTableResponse with the rows of the page and the filter counts
+        """
+        return self._get_table(
+            "/shared-projects",
+            params,
+            scope=scope,
+            search=search,
+            page=page,
+            per_page=per_page,
+            sort_by=sort_by,
+            sort_order=sort_order,
+        )
+
+    def get_shared_project(
+        self,
+        project_name: str,
+        params: UsageAttributionQueryParams | None = None,
+    ) -> UsageAttributionResponse:
+        """Get the popup of one shared project.
+
+        Args:
+            project_name: Name of the project
+            params: Period parameters
+
+        Returns:
+            UsageAttributionResponse whose data holds ``row`` and ``detail``
+
+        Raises:
+            requests.HTTPError: 404 when the project is not in the analysis of the period
+        """
+        return self._get_view(
+            f"/shared-projects/{quote(project_name, safe='')}", params
+        )
+
+    def get_repository_groups(
+        self,
+        params: UsageAttributionQueryParams | None = None,
+        scope: str | None = None,
+        search: str | None = None,
+        page: int | None = None,
+        per_page: int | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> UsageAttributionTableResponse:
+        """List repository groups in personal projects.
+
+        Args:
+            params: Period parameters
+            scope: "threshold" (default) or "all"
+            search: Case-insensitive text to find in the group name or its repositories
+            page: Zero-indexed page number
+            per_page: Items per page
+            sort_by: Column to sort by
+            sort_order: "asc" or "desc"
+
+        Returns:
+            UsageAttributionTableResponse with the rows of the page and the filter counts
+        """
+        return self._get_table(
+            "/repository-groups",
+            params,
+            scope=scope,
+            search=search,
+            page=page,
+            per_page=per_page,
+            sort_by=sort_by,
+            sort_order=sort_order,
+        )
+
+    def get_repository_group(
+        self,
+        group_id: str,
+        params: UsageAttributionQueryParams | None = None,
+    ) -> UsageAttributionResponse:
+        """Get the popup of one repository group.
+
+        Args:
+            group_id: Group id as listed by get_repository_groups
+            params: Period parameters
+
+        Returns:
+            UsageAttributionResponse whose data holds ``row`` and ``detail``
+
+        Raises:
+            requests.HTTPError: 404 when the group is not in the analysis of the period
+        """
+        return self._get_view(f"/repository-groups/{quote(group_id, safe='')}", params)
+
+    def get_people(
+        self,
+        params: UsageAttributionQueryParams | None = None,
+        filter: str | None = None,
+        search: str | None = None,
+        page: int | None = None,
+        per_page: int | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> UsageAttributionTableResponse:
+        """List people with their spend.
+
+        Args:
+            params: Period parameters
+            filter: "all" (default), "cand", "prod", "exp", "shared" or "platform"
+            search: Case-insensitive text to find in the name, e-mail or main repository
+            page: Zero-indexed page number
+            per_page: Items per page
+            sort_by: Column to sort by
+            sort_order: "asc" or "desc"
+
+        Returns:
+            UsageAttributionTableResponse with the rows of the page and a count per filter
+        """
+        return self._get_table(
+            "/people",
+            params,
+            filter=filter,
+            search=search,
+            page=page,
+            per_page=per_page,
+            sort_by=sort_by,
+            sort_order=sort_order,
+        )
+
+    def get_person(
+        self,
+        user_id: str,
+        params: UsageAttributionQueryParams | None = None,
+    ) -> UsageAttributionResponse:
+        """Get the popup of one person.
+
+        Args:
+            user_id: User id as listed by get_people
+            params: Period parameters
+
+        Returns:
+            UsageAttributionResponse whose data holds ``row`` and ``detail``
+
+        Raises:
+            requests.HTTPError: 404 when the person is not in the analysis of the period
+        """
+        return self._get_view(f"/people/{quote(user_id, safe='')}", params)
+
+    def get_breakdown(
+        self,
+        params: UsageAttributionQueryParams | None = None,
+        dimension: str | None = None,
+        category: str | None = None,
+    ) -> UsageAttributionResponse:
+        """Get CLI spend paid from personal budgets, by country or job title group.
+
+        Args:
+            params: Period parameters
+            dimension: "country" (default) or "job"
+            category: "production" (default), "learning", "testing", "experimental",
+                "pet_project" or "unclassified"
+
+        Returns:
+            UsageAttributionResponse whose data holds ``rows`` (label and spend) and ``total``
+
+        Raises:
+            requests.HTTPError: 404 when user enrichment is disabled
+        """
+        return self._get_view(
+            "/breakdown", params, dimension=dimension, category=category
+        )

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

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

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

@@ -1,4 +1,4 @@
-codemie_sdk/__init__.py,sha256=b3eCiXsjw_q4eubzF97OEDYNJKMq4U98ekRNgvqmcuo,9014
+codemie_sdk/__init__.py,sha256=yOdC5rH8Q7vFn6odg1dzczxzXfsqfZ69Jw36cXg2bO0,9627
 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,7 +7,7 @@ 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=GCTLzF2CPtWI3QPMDerBcQpHuuBx06iQabP4__8SRq0,9996
+codemie_sdk/client/client.py,sha256=J-PfxYNwB5XAU5d7BAVOaOGmOKM94bzvvf2Itrw6D7Y,10202
 codemie_sdk/exceptions.py,sha256=uuzvtvYBMzrNGt7Q4k5RVq0Pd8eJ_tR2tLy3pF2ICDs,1148
 codemie_sdk/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 codemie_sdk/models/a2a.py,sha256=93GGBg4vkrlnuGCtakMLgYtrD9U54Dme9Dm5sJGO2bc,1986
@@ -31,6 +31,7 @@ codemie_sdk/models/project.py,sha256=9nMsPNw0mUHud2sAISXrJx2lXz9VKw2Dn-ABq53UgZ8
 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/usage_attribution.py,sha256=uMHmtcTGD65kf6ZWHvNpRGwpV-kAUl1b5S01vq76OV0,4444
 codemie_sdk/models/user.py,sha256=YqPWzTgIKF-7Jw6aV7RD__su1iahEJPGaDR6Px-B4bU,3848
 codemie_sdk/models/vendor_assistant.py,sha256=vdpFq8aRlLj7IgRMWTA6pkrq8HZty8rgwA-kWrKKf3A,6357
 codemie_sdk/models/vendor_guardrail.py,sha256=dQtuFZXFUs_IUQlnPQth0Sd49Sx9gfDtkA2bB2Qh5e0,5227
@@ -65,6 +66,7 @@ codemie_sdk/services/project_budget_groups.py,sha256=B7QJt3sh_LV3lfwALZlxUq0SLR3
 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/usage_attribution.py,sha256=iLjs4trg3Fj_uapLW1PAHgrtkVb2hiTPjRKOvO1vdaY,10782
 codemie_sdk/services/user.py,sha256=W0-fkY6vIbJDlIpb2PxxljSMOdWh910BmBK-n94gBs0,6998
 codemie_sdk/services/vendor_assistant.py,sha256=Vwa0rH8TYTCV1iAeKuSP5skbX8V04NLXE0g9VQRKqGI,13484
 codemie_sdk/services/vendor_guardrail.py,sha256=HFDRPKb1wXhz4sG_XUISLcBHvZB2bJkqxLCUlG_SS5Q,14280
@@ -78,6 +80,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.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,,
+codemie_sdk_python-0.1.706.dist-info/METADATA,sha256=U0IJS0NRdpGniojMRgUeqDZRsMRUUTvEB-sybGaSWkk,47938
+codemie_sdk_python-0.1.706.dist-info/WHEEL,sha256=L-WvLdSBvJWHXv5zrQxDvNRnIgoBzLUpcbuiw19KCuQ,88
+codemie_sdk_python-0.1.706.dist-info/RECORD,,