codemie-sdk-python 0.1.434__tar.gz → 0.1.436__tar.gz

{codemie_sdk_python-0.1.434 → codemie_sdk_python-0.1.436}/PKG-INFO

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

{codemie_sdk_python-0.1.434 → codemie_sdk_python-0.1.436}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "codemie-sdk-python"
-version = "0.1.434"
+version = "0.1.436"
 description = "CodeMie SDK for Python"
 authors = [
     "Vadym Vlasenko <vadym_vlasenko@epam.com>",

{codemie_sdk_python-0.1.434 → codemie_sdk_python-0.1.436}/src/codemie_sdk/__init__.py

@@ -125,6 +125,11 @@ from .models.skill import (
     SkillDetailResponse,
     SkillListResponse,
     SkillListPaginatedResponse,
+    SkillEventRequest,
+    SkillEventItem,
+    SkillStatsItem,
+    SingleSkillStatsResponse,
+    SkillPagination,
 )
 from .services.skill import SkillService
 
@@ -221,5 +226,10 @@ __all__ = [
     "SkillDetailResponse",
     "SkillListResponse",
     "SkillListPaginatedResponse",
+    "SkillEventRequest",
+    "SkillEventItem",
+    "SkillStatsItem",
+    "SingleSkillStatsResponse",
+    "SkillPagination",
     "SkillService",
 ]

{codemie_sdk_python-0.1.434 → codemie_sdk_python-0.1.436}/src/codemie_sdk/models/skill.py

@@ -2,6 +2,7 @@
 
 from datetime import datetime
 from enum import Enum
+from typing import Any, Literal
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -122,3 +123,90 @@ class SkillReactionResponse(BaseModel):
     reaction: str
     reaction_at: str = Field(alias="reactionAt")
     resource_type: str | None = Field(None, alias="resourceType")
+
+
+class SkillPagination(BaseModel):
+    """Shared pagination envelope for skills statistics endpoints."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    page: int
+    per_page: int
+    total: int
+    pages: int
+
+
+class SkillEventRequest(BaseModel):
+    """Request body for POST /v1/skills/events."""
+
+    session_id: str
+    command: Literal["add", "update", "remove", "list", "find"]
+    status: Literal["started", "completed", "failed"]
+    scope: Literal["global", "project", "unknown"] | None = None
+    error_code: str | None = None
+    agent_selection_mode: (
+        Literal["explicit", "auto_detected", "prompted", "upstream"] | None
+    ) = None
+    target_agents: list[str] | None = None
+    source: str | None = None
+    skill_name: str | None = None
+    skill_slug: str | None = None
+    skill_id: str | None = None
+    agent: str = "codemie-skills"
+    agent_version: str | None = None
+    repository: str | None = None
+    branch: str | None = None
+    project: str | None = None
+    attributes: dict[str, Any] | None = None
+
+
+class SkillEventItem(BaseModel):
+    """Single row from the raw event log."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    skill_slug: str | None = None
+    source: str | None = None
+    target_agents: list[str] = Field(default_factory=list)
+    date: datetime
+    command: str
+    user_id: str
+
+
+class SkillEventsPaginatedResponse(BaseModel):
+    """Paginated response from GET /v1/skills/events."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: list[SkillEventItem]
+    pagination: SkillPagination
+
+
+class SkillStatsItem(BaseModel):
+    """Per-skill aggregated stats item."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    skill_slug: str | None = None
+    installs: int
+    removals: int
+    by_agent: dict[str, int] = Field(default_factory=dict)
+
+
+class SkillStatsPaginatedResponse(BaseModel):
+    """Paginated response from GET /v1/skills/events/stats."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: list[SkillStatsItem]
+    pagination: SkillPagination
+
+
+class SingleSkillStatsResponse(BaseModel):
+    """Response from GET /v1/skills/events/{slug}/stats."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    installs: int
+    removals: int
+    by_agent: dict[str, int] = Field(default_factory=dict)

{codemie_sdk_python-0.1.434 → codemie_sdk_python-0.1.436}/src/codemie_sdk/services/skill.py

@@ -11,10 +11,14 @@ from ..models.skill import (
     SkillCategory,
     SkillCreateRequest,
     SkillDetailResponse,
+    SkillEventItem,
+    SkillEventRequest,
     SkillImportRequest,
     SkillListPaginatedResponse,
     SkillListResponse,
+    SkillStatsItem,
     SkillUpdateRequest,
+    SingleSkillStatsResponse,
 )
 from ..utils.http import ApiRequestHandler, TokenSource
 
@@ -302,3 +306,85 @@ class SkillService:
             Removal confirmation
         """
         return self._api.delete(f"/v1/skills/{skill_id}/reactions", dict)
+
+    # Statistics / Event Log
+
+    def record_event(self, request: SkillEventRequest) -> dict:
+        """Record a skill lifecycle event.
+
+        Args:
+            request: Skill event request
+
+        Returns:
+            Confirmation dict
+        """
+        return self._api.post(
+            "/v1/skills/events",
+            dict,
+            json_data=request.model_dump(exclude_none=True),
+        )
+
+    def get_events(
+        self,
+        from_: str | None = None,
+        to: str | None = None,
+        limit: int = 100,
+        offset: int = 0,
+    ) -> list[SkillEventItem]:
+        """Get raw skill event log.
+
+        Args:
+            from_: ISO datetime lower bound (inclusive)
+            to: ISO datetime upper bound (inclusive)
+            limit: Maximum number of results
+            offset: Pagination offset
+
+        Returns:
+            List of skill event items
+        """
+        params: dict[str, Any] = {"limit": limit, "offset": offset}
+        if from_ is not None:
+            params["from"] = from_
+        if to is not None:
+            params["to"] = to
+        return self._api.get("/v1/skills/events", list[SkillEventItem], params=params)
+
+    def get_events_stats(
+        self,
+        from_: str | None = None,
+        to: str | None = None,
+        limit: int = 100,
+        offset: int = 0,
+    ) -> list[SkillStatsItem]:
+        """Get per-skill aggregated install/removal counts.
+
+        Args:
+            from_: ISO datetime lower bound (inclusive)
+            to: ISO datetime upper bound (inclusive)
+            limit: Maximum number of results
+            offset: Pagination offset
+
+        Returns:
+            List of skill stats items
+        """
+        params: dict[str, Any] = {"limit": limit, "offset": offset}
+        if from_ is not None:
+            params["from"] = from_
+        if to is not None:
+            params["to"] = to
+        return self._api.get(
+            "/v1/skills/events/stats", list[SkillStatsItem], params=params
+        )
+
+    def get_skill_stats(self, slug: str) -> SingleSkillStatsResponse:
+        """Get aggregated stats for a single skill.
+
+        Args:
+            slug: Skill slug identifier
+
+        Returns:
+            Single skill stats
+        """
+        return self._api.get(
+            f"/v1/skills/events/{slug}/stats", SingleSkillStatsResponse
+        )