codemie-sdk-python 0.1.691__py3-none-any.whl → 0.1.693__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/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_python-0.1.691.dist-info → codemie_sdk_python-0.1.693.dist-info}/METADATA

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

{codemie_sdk_python-0.1.691.dist-info → codemie_sdk_python-0.1.693.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
@@ -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
@@ -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.691.dist-info/METADATA,sha256=5Ik4BOiQjqb5jMGCNjQ5pNYNJfoNzP1Ea64_l1EpWyY,47441
-codemie_sdk_python-0.1.691.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-codemie_sdk_python-0.1.691.dist-info/RECORD,,
+codemie_sdk_python-0.1.693.dist-info/METADATA,sha256=ttRmWG0jDWKnF8N9kyS-tW83GnZ6d3r-iiNIT7F5JVg,47441
+codemie_sdk_python-0.1.693.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+codemie_sdk_python-0.1.693.dist-info/RECORD,,