codemie-sdk-python 0.1.690__py3-none-any.whl → 0.1.692__py3-none-any.whl

codemie_sdk/__init__.py

@@ -93,6 +93,13 @@ from .models.analytics import (
     UsersListResponse,
     AnalyticsQueryParams,
     PaginatedAnalyticsQueryParams,
+    CliAnalyticsQueryParams,
+    CliAnalyticsSessionsQueryParams,
+    CliAnalyticsCostResponse,
+    CliAnalyticsUsersResponse,
+    CliAnalyticsSessionsResponse,
+    CliAnalyticsSessionDetailResponse,
+    CliAnalyticsRepositoriesResponse,
 )
 from .services.customer_config_service import CustomerConfigService
 from .services.vendor_assistant import VendorAssistantService
@@ -253,6 +260,13 @@ __all__ = [
     "UsersListResponse",
     "AnalyticsQueryParams",
     "PaginatedAnalyticsQueryParams",
+    "CliAnalyticsQueryParams",
+    "CliAnalyticsSessionsQueryParams",
+    "CliAnalyticsCostResponse",
+    "CliAnalyticsUsersResponse",
+    "CliAnalyticsSessionsResponse",
+    "CliAnalyticsSessionDetailResponse",
+    "CliAnalyticsRepositoriesResponse",
     "AnalyticsService",
     "CustomerConfigService",
     "MermaidDiagramRequest",

codemie_sdk/models/analytics.py

@@ -146,3 +146,193 @@ class PaginatedAnalyticsQueryParams(AnalyticsQueryParams):
 
     page: int = Field(0, description="Zero-indexed page number")
     per_page: int = Field(20, description="Items per page")
+
+
+# ── CLI Analytics: /v1/analytics/cli-analytics/* ─────────────────────────────
+
+
+class CliAnalyticsQueryParams(AnalyticsQueryParams):
+    """Filters shared by the /v1/analytics/cli-analytics/* read endpoints."""
+
+    repositories: str | None = Field(
+        None, description="Comma-separated repository names"
+    )
+
+
+class CliAnalyticsSessionsQueryParams(CliAnalyticsQueryParams):
+    """Query parameters of the CLI Analytics session list."""
+
+    page: int | None = Field(None, description="Zero-indexed page number")
+    per_page: int | None = Field(None, description="Items per page")
+    is_unattributed: bool | None = Field(
+        None, description="Only sessions with no attributed repository"
+    )
+
+
+class CliAnalyticsMetadata(BaseModel):
+    """Metadata of CLI Analytics responses."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    timestamp: str = Field(description="ISO 8601 timestamp when response generated")
+    data_as_of: str = Field(description="ISO 8601 date/datetime of the newest data")
+    execution_time_ms: float = Field(description="Query execution time in milliseconds")
+
+
+class CliAnalyticsCostKpis(BaseModel):
+    """Totals of the CLI Analytics cost breakdown."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    total_sessions: int
+    total_cost_usd: float
+    total_tokens: int
+    avg_cost_per_session: float
+
+
+class CliAnalyticsCostByUser(BaseModel):
+    """Cost of one user."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    developer_name: str
+    cost_usd: float
+
+
+class CliAnalyticsCostByModel(BaseModel):
+    """Cost of one model."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    model_name: str
+    cost_usd: float
+
+
+class CliAnalyticsCostData(BaseModel):
+    """Cost breakdown data."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    kpis: CliAnalyticsCostKpis
+    cost_by_user: list[CliAnalyticsCostByUser] = Field(default_factory=list)
+    cost_by_model: list[CliAnalyticsCostByModel] = Field(default_factory=list)
+
+
+class CliAnalyticsCostResponse(BaseModel):
+    """Response of GET /v1/analytics/cli-analytics/cost."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: CliAnalyticsCostData
+    metadata: CliAnalyticsMetadata
+
+
+class CliAnalyticsUserRow(BaseModel):
+    """One user of the CLI Analytics user leaderboard."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    developer_name: str = Field(description="Resolved user email")
+    session_count: int
+    input_tokens: int
+    output_tokens: int
+    cache_read_tokens: int
+    cache_creation_tokens: int
+    cost_usd: float
+
+
+class CliAnalyticsUsersData(BaseModel):
+    """User leaderboard data."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    rows: list[CliAnalyticsUserRow]
+    avg_session_duration_ms: int | None = None
+    total_count: int | None = None
+
+
+class CliAnalyticsUsersResponse(BaseModel):
+    """Response of GET /v1/analytics/cli-analytics/users."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: CliAnalyticsUsersData
+    metadata: CliAnalyticsMetadata
+
+
+class CliAnalyticsSessionRow(BaseModel):
+    """One CLI session."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    trace_id: str = Field(description="Session id")
+    developer_name: str = Field(description="Resolved user email")
+    repository: str | None = Field(None, description="None when unattributed")
+    branch: str | None = None
+    start_time: str = Field(description="ISO 8601 session start")
+    duration_ms: int = Field(description="Session start to its last event")
+    model_name: str
+    input_tokens: int
+    output_tokens: int
+    cache_read_tokens: int = 0
+    cache_creation_tokens: int = 0
+    cost_usd: float
+
+
+class CliAnalyticsSessionsData(BaseModel):
+    """Session list data."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    sessions: list[CliAnalyticsSessionRow]
+    page: int
+    per_page: int
+    total: int
+
+
+class CliAnalyticsSessionsResponse(BaseModel):
+    """Response of GET /v1/analytics/cli-analytics/sessions."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: CliAnalyticsSessionsData
+    metadata: CliAnalyticsMetadata
+
+
+class CliAnalyticsSessionDetailResponse(BaseModel):
+    """Response of GET /v1/analytics/cli-analytics/sessions/{trace_id}."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: CliAnalyticsSessionRow
+    metadata: CliAnalyticsMetadata
+
+
+class CliAnalyticsRepositoryRow(BaseModel):
+    """One repository (or repository branch) of the CLI Analytics breakdown."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    repository: str | None = Field(None, description="None for unattributed sessions")
+    branch: str | None = None
+    session_count: int
+    cost_usd: float
+    project_name: str | None = None
+
+
+class CliAnalyticsRepositoriesData(BaseModel):
+    """Repository breakdown data."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    rows: list[CliAnalyticsRepositoryRow]
+    pagination: PaginationMetadata
+
+
+class CliAnalyticsRepositoriesResponse(BaseModel):
+    """Response of GET /v1/analytics/cli-analytics/repositories."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: CliAnalyticsRepositoriesData
+    metadata: CliAnalyticsMetadata

codemie_sdk/models/project.py

@@ -176,6 +176,24 @@ class ProjectUpdateRequest(BaseModel):
     chargeback_attribution: str | None = None
 
 
+class ProjectOwnershipUpdateRequest(BaseModel):
+    """Request to transfer project ownership to another user."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    user_id: str
+
+
+class ProjectOwnershipUpdateResponse(BaseModel):
+    """Response after transferring project ownership."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    created_by: str
+    message: str
+
+
 class ProjectDeleteResponse(BaseModel):
     """Response after deleting a project."""
 

codemie_sdk/services/analytics.py

@@ -4,6 +4,13 @@ import json
 
 from ..models.analytics import (
     AnalyticsQueryParams,
+    CliAnalyticsCostResponse,
+    CliAnalyticsQueryParams,
+    CliAnalyticsRepositoriesResponse,
+    CliAnalyticsSessionDetailResponse,
+    CliAnalyticsSessionsQueryParams,
+    CliAnalyticsSessionsResponse,
+    CliAnalyticsUsersResponse,
     PaginatedAnalyticsQueryParams,
     SummariesResponse,
     TabularResponse,
@@ -581,3 +588,93 @@ class AnalyticsService:
             params=kwargs if kwargs else None,
             wrap_response=False,
         )
+
+    # ── CLI Analytics: /v1/analytics/cli-analytics/* ─────────────────────────
+
+    def ingest_cli_analytics_event_hooks(self, events: list[dict]) -> None:
+        """POST /v1/analytics/cli-analytics/event-hooks — send CLI hook events.
+
+        The endpoint takes NDJSON (one event per line); each event is posted as
+        its own single-line body.
+
+        Args:
+            events: Hook events, e.g. ``agent.session.start``, ``agent.usage.request``
+        """
+        for event in events:
+            self._api.post(
+                "/v1/analytics/cli-analytics/event-hooks",
+                dict,
+                json_data=event,
+                wrap_response=False,
+                extra_headers={"Content-Type": "application/x-ndjson"},
+            )
+
+    def ingest_cli_analytics_logs(self, payload: dict) -> None:
+        """POST /v1/analytics/cli-analytics/logs — send OTLP logs as JSON.
+
+        Args:
+            payload: An OTLP ``ExportLogsServiceRequest`` in its JSON form
+        """
+        self._api.post(
+            "/v1/analytics/cli-analytics/logs",
+            dict,
+            json_data=payload,
+            wrap_response=False,
+        )
+
+    def get_cli_analytics_cost(
+        self, params: CliAnalyticsQueryParams | None = None
+    ) -> CliAnalyticsCostResponse:
+        """GET /v1/analytics/cli-analytics/cost — session, token and cost totals."""
+        return self._api.get(
+            "/v1/analytics/cli-analytics/cost",
+            CliAnalyticsCostResponse,
+            params=params.model_dump(exclude_none=True) if params else {},
+            wrap_response=False,
+        )
+
+    def get_cli_analytics_users(
+        self, params: CliAnalyticsQueryParams | None = None
+    ) -> CliAnalyticsUsersResponse:
+        """GET /v1/analytics/cli-analytics/users — per-user sessions and tokens."""
+        return self._api.get(
+            "/v1/analytics/cli-analytics/users",
+            CliAnalyticsUsersResponse,
+            params=params.model_dump(exclude_none=True) if params else {},
+            wrap_response=False,
+        )
+
+    def get_cli_analytics_sessions(
+        self, params: CliAnalyticsSessionsQueryParams | None = None
+    ) -> CliAnalyticsSessionsResponse:
+        """GET /v1/analytics/cli-analytics/sessions — paginated session list."""
+        return self._api.get(
+            "/v1/analytics/cli-analytics/sessions",
+            CliAnalyticsSessionsResponse,
+            params=params.model_dump(exclude_none=True) if params else {},
+            wrap_response=False,
+        )
+
+    def get_cli_analytics_session(
+        self, trace_id: str
+    ) -> CliAnalyticsSessionDetailResponse:
+        """GET /v1/analytics/cli-analytics/sessions/{trace_id} — session detail."""
+        return self._api.get(
+            f"/v1/analytics/cli-analytics/sessions/{trace_id}",
+            CliAnalyticsSessionDetailResponse,
+            wrap_response=False,
+        )
+
+    def get_cli_analytics_repositories(
+        self, params: CliAnalyticsQueryParams | None = None
+    ) -> CliAnalyticsRepositoriesResponse:
+        """GET /v1/analytics/cli-analytics/repositories — per-repository breakdown.
+
+        Without pagination parameters the endpoint returns every repository branch.
+        """
+        return self._api.get(
+            "/v1/analytics/cli-analytics/repositories",
+            CliAnalyticsRepositoriesResponse,
+            params=params.model_dump(exclude_none=True) if params else {},
+            wrap_response=False,
+        )

codemie_sdk/services/project.py

@@ -30,6 +30,8 @@ from ..models.project import (
     ProjectCreateResponse,
     ProjectDeleteResponse,
     ProjectDetailResponse,
+    ProjectOwnershipUpdateRequest,
+    ProjectOwnershipUpdateResponse,
     ProjectUpdateRequest,
     ProjectUpdateResponse,
 )
@@ -217,6 +219,33 @@ class ProjectService:
             response_model=ProjectDeleteResponse,
         )
 
+    def transfer_ownership(
+        self,
+        project_name: str,
+        user_id: str,
+    ) -> ProjectOwnershipUpdateResponse:
+        """Transfer ownership of a project to another active user.
+
+        Args:
+            project_name: Project name
+            user_id: ID of the user who becomes the new owner
+
+        Returns:
+            ProjectOwnershipUpdateResponse with the project name, new owner id and message
+
+        Raises:
+            HTTPException: 404 if the project or the target user is not found, or the
+                caller may not manage the project; 403 if the project is personal
+        """
+        payload = ProjectOwnershipUpdateRequest(user_id=user_id)
+
+        return self._api.put(
+            f"/v1/projects/{project_name}/ownership",
+            response_model=ProjectOwnershipUpdateResponse,
+            json_data=payload.model_dump(),
+            wrap_response=False,
+        )
+
     # Assignment endpoints
 
     def assign_user_to_project(

{codemie_sdk_python-0.1.690.dist-info → codemie_sdk_python-0.1.692.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codemie-sdk-python
-Version: 0.1.690
+Version: 0.1.692
 Summary: CodeMie SDK for Python
 Author: Vadym Vlasenko
 Author-email: vadym_vlasenko@epam.com

{codemie_sdk_python-0.1.690.dist-info → codemie_sdk_python-0.1.692.dist-info}/RECORD

@@ -1,4 +1,4 @@
-codemie_sdk/__init__.py,sha256=4l9nNwAgobEYrjLYkOuGYBH-KDagfp-03QPkn1aXcmg,8310
+codemie_sdk/__init__.py,sha256=9pK9aoMg0gpyYA1WqOjxGVMOX0tuRUszLdenKikbDIc,8800
 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
@@ -13,7 +13,7 @@ codemie_sdk/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuF
 codemie_sdk/models/a2a.py,sha256=zCNLiwwg78rok04hMlGPcQQS1IbEV4OaMcA_1KxQ9xs,1588
 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=B29Cqt2Mvqohfjz-keRV5gFBpTKw_iIkF2ARxmEUv-Y,4953
+codemie_sdk/models/analytics.py,sha256=B9lLAddL_LylXsoOukiPqbz4HVd2itmuB6iaEbhpKiQ,10194
 codemie_sdk/models/assistant.py,sha256=BkMMIBKA3fibL98PsyEtlIcvZql63oVdI9Pgy9YnemI,22230
 codemie_sdk/models/categories.py,sha256=eq7_sw-sevNLeWpjaW3N055Xcgbbevs0Bl_rj--maUk,2303
 codemie_sdk/models/common.py,sha256=ipNNdQlv4Ct1UyIAknjJbrdjjvv0lZJYK6dnPm8wai4,1170
@@ -27,7 +27,7 @@ codemie_sdk/models/integration.py,sha256=yBV28vZ8oN0oNRNHdDPL3UUSJqNga1YodABIfX8
 codemie_sdk/models/llm.py,sha256=ViADvsSAkc85YQyPUkGE3ZvMc5pnHWHO0_rOkLSTfu4,1333
 codemie_sdk/models/mcp_config.py,sha256=mvD2utb4fthjNGAIkZKEkTtHSQQyF2WEYrA7tn-e0Lo,2184
 codemie_sdk/models/mermaid.py,sha256=dhRgX-itvfyrt0LUg5pbSo0CTH5PewiegqcZn3hWggU,675
-codemie_sdk/models/project.py,sha256=_iE45WdlAufZIW0XyqwxExOhHhSVY-YLs--68phj5tQ,6983
+codemie_sdk/models/project.py,sha256=MWBWg_G373v8OHX_INqvZZg6TlRY0w8G_HDBqPa_CL0,7370
 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
@@ -45,7 +45,7 @@ codemie_sdk/models/workspace.py,sha256=xYnVO1Pnd0l0PSBe2pwP80C2ZvYBc2ESo6OH_G0cO
 codemie_sdk/services/a2a.py,sha256=JI_heDKmQ1qYGIES_6qPosHRyVb73tKs4v7uTGpzXx4,1026
 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=JtBhlilU2uHjVmqzf_4TyF-j6vVVDMK6n_YJ07hCxZ4,19360
+codemie_sdk/services/analytics.py,sha256=wcbbzm9L4YLXy7I054jM8LYlIQnz3gB2K56--OkVT4g,23148
 codemie_sdk/services/assistant.py,sha256=3fHK2cJERgNJJfkvdih0h7bRHdHjlIJHBcS7EcnJ90E,22135
 codemie_sdk/services/categories.py,sha256=1qd98JCcMNdpbos0O1WpMApT6TurE7OuI7zoYewnwk8,5030
 codemie_sdk/services/codemie_guardrails.py,sha256=O3yCeIQYG8W7z-sVRR4Cw9UVncqP9lPVNxUSaUZrh7I,2833
@@ -59,7 +59,7 @@ codemie_sdk/services/integration.py,sha256=n4ggDedJ2GCI5mTgZNfrYE49uzLsp_BKYKMdT
 codemie_sdk/services/llm.py,sha256=GQWIi359f99uU4YRnAdpbyae1kXp1G5OpVgJNIIn7-8,1132
 codemie_sdk/services/mcp_configs.py,sha256=MrCiWJ6-ezXE9NOTgOfHDhfyQokaumGp1rwB4IAKXzs,2466
 codemie_sdk/services/mermaid.py,sha256=7cLykdrJVW576raUbON3yhuWnbGaXl8rX1QfVwbu2JE,2246
-codemie_sdk/services/project.py,sha256=ajs5ZEc7L9k6qJGjX28_LF6mrExC-uYvWhd3AuQBX_w,13309
+codemie_sdk/services/project.py,sha256=2O57E63mkt5Z-OwTksxiKplRDHwh6MV_COaztXO7j4A,14298
 codemie_sdk/services/project_budget_groups.py,sha256=B7QJt3sh_LV3lfwALZlxUq0SLR30BWafHcS6eHyOh8Y,5471
 codemie_sdk/services/skill.py,sha256=0mExdeKTMNqkEpKafD0ya1WyLj9CMCFaprkggKYqnQg,13216
 codemie_sdk/services/task.py,sha256=UaYh__xGF7VKWCJKPrncVjTvx46Gz1AN9XczPVL71oA,1052
@@ -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.690.dist-info/METADATA,sha256=6nvAIpO__3TgP63FlWNCzHfoExuIW6sRZZVyX5n_LE0,47441
-codemie_sdk_python-0.1.690.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-codemie_sdk_python-0.1.690.dist-info/RECORD,,
+codemie_sdk_python-0.1.692.dist-info/METADATA,sha256=ay9di79CYESHDIo4qGdC0AynO_AYQJYp_mu2gT-f32c,47441
+codemie_sdk_python-0.1.692.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+codemie_sdk_python-0.1.692.dist-info/RECORD,,