convexity-api-client 0.12.0.dev229__tar.gz → 0.12.0.dev230__tar.gz

{convexity_api_client-0.12.0.dev229 → convexity_api_client-0.12.0.dev230}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: convexity_api_client
-Version: 0.12.0.dev229
+Version: 0.12.0.dev230
 Summary: A client library for accessing Convexity API
 Requires-Dist: httpx>=0.23.0,<0.29.0
 Requires-Dist: attrs>=22.2.0

convexity_api_client-0.12.0.dev230/convexity_api_client/api/v1/get_project_usage_v1_projects_project_id_usage_get.py

@@ -0,0 +1,194 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.http_validation_error import HTTPValidationError
+from ...models.project_usage_response import ProjectUsageResponse
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    project_id: str,
+    *,
+    days: int | Unset = 30,
+) -> dict[str, Any]:
+
+    params: dict[str, Any] = {}
+
+    params["days"] = days
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/projects/{project_id}/usage".format(
+            project_id=quote(str(project_id), safe=""),
+        ),
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | ProjectUsageResponse | None:
+    if response.status_code == 200:
+        response_200 = ProjectUsageResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[HTTPValidationError | ProjectUsageResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    project_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    days: int | Unset = 30,
+) -> Response[HTTPValidationError | ProjectUsageResponse]:
+    """Get project resource usage overview
+
+     Returns aggregated token usage, task/run execution, and storage metrics for a project within the
+    specified time range.
+
+    Args:
+        project_id (str):
+        days (int | Unset): Look-back window in days Default: 30.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[HTTPValidationError | ProjectUsageResponse]
+    """
+
+    kwargs = _get_kwargs(
+        project_id=project_id,
+        days=days,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    project_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    days: int | Unset = 30,
+) -> HTTPValidationError | ProjectUsageResponse | None:
+    """Get project resource usage overview
+
+     Returns aggregated token usage, task/run execution, and storage metrics for a project within the
+    specified time range.
+
+    Args:
+        project_id (str):
+        days (int | Unset): Look-back window in days Default: 30.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        HTTPValidationError | ProjectUsageResponse
+    """
+
+    return sync_detailed(
+        project_id=project_id,
+        client=client,
+        days=days,
+    ).parsed
+
+
+async def asyncio_detailed(
+    project_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    days: int | Unset = 30,
+) -> Response[HTTPValidationError | ProjectUsageResponse]:
+    """Get project resource usage overview
+
+     Returns aggregated token usage, task/run execution, and storage metrics for a project within the
+    specified time range.
+
+    Args:
+        project_id (str):
+        days (int | Unset): Look-back window in days Default: 30.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[HTTPValidationError | ProjectUsageResponse]
+    """
+
+    kwargs = _get_kwargs(
+        project_id=project_id,
+        days=days,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    project_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    days: int | Unset = 30,
+) -> HTTPValidationError | ProjectUsageResponse | None:
+    """Get project resource usage overview
+
+     Returns aggregated token usage, task/run execution, and storage metrics for a project within the
+    specified time range.
+
+    Args:
+        project_id (str):
+        days (int | Unset): Look-back window in days Default: 30.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        HTTPValidationError | ProjectUsageResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            project_id=project_id,
+            client=client,
+            days=days,
+        )
+    ).parsed

{convexity_api_client-0.12.0.dev229 → convexity_api_client-0.12.0.dev230}/convexity_api_client/api/v1/proxy_claude_messages_v1_claude_v1_messages_post.py

@@ -45,7 +45,7 @@ def sync_detailed(
 
      Proxy endpoint for Claude Messages API.
 
-    Forwards requests directly to Anthropic's Claude API.
+    Forwards requests directly to Anthropic's Claude API and records token usage.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -72,7 +72,7 @@ async def asyncio_detailed(
 
      Proxy endpoint for Claude Messages API.
 
-    Forwards requests directly to Anthropic's Claude API.
+    Forwards requests directly to Anthropic's Claude API and records token usage.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

{convexity_api_client-0.12.0.dev229 → convexity_api_client-0.12.0.dev230}/convexity_api_client/models/__init__.py

@@ -109,6 +109,8 @@ from .create_share_request import CreateShareRequest
 from .create_task_request import CreateTaskRequest
 from .create_webhook_connection_request import CreateWebhookConnectionRequest
 from .csv_dataset_config import CsvDatasetConfig
+from .daily_run_stats import DailyRunStats
+from .daily_token_usage import DailyTokenUsage
 from .dashboard import Dashboard
 from .dashboard_button_widget import DashboardButtonWidget
 from .dashboard_chart_widget import DashboardChartWidget
@@ -251,6 +253,7 @@ from .project_resource_changed_payload_metadata_type_0 import ProjectResourceCha
 from .project_resource_changed_payload_resource_type import ProjectResourceChangedPayloadResourceType
 from .project_response import ProjectResponse
 from .project_settings import ProjectSettings
+from .project_usage_response import ProjectUsageResponse
 from .public_dashboard_response import PublicDashboardResponse
 from .public_dashboard_response_filters_type_0_item import PublicDashboardResponseFiltersType0Item
 from .refresh_dataset_payload import RefreshDatasetPayload
@@ -269,6 +272,7 @@ from .restart_run_response import RestartRunResponse
 from .restore_status_type_def import RestoreStatusTypeDef
 from .review_issue_request import ReviewIssueRequest
 from .run import Run
+from .run_stats import RunStats
 from .run_stats_response import RunStatsResponse
 from .s3_connection import S3Connection
 from .s3_object_content import S3ObjectContent
@@ -312,11 +316,15 @@ from .task_list_response import TaskListResponse
 from .task_model import TaskModel
 from .task_model_parameter_schema_type_0 import TaskModelParameterSchemaType0
 from .task_scenario import TaskScenario
+from .task_stats import TaskStats
+from .task_stats_by_scenario import TaskStatsByScenario
 from .token_balance import TokenBalance
 from .token_package import TokenPackage
 from .token_purchase import TokenPurchase
 from .token_response import TokenResponse
 from .token_usage import TokenUsage
+from .token_usage_stats import TokenUsageStats
+from .token_usage_stats_by_model import TokenUsageStatsByModel
 from .tooltip_config import TooltipConfig
 from .tooltip_series_config import TooltipSeriesConfig
 from .tooltip_series_config_format_type_0 import TooltipSeriesConfigFormatType0
@@ -355,6 +363,9 @@ from .visual_encoding_config_style_palette_type_0_item import VisualEncodingConf
 from .visual_encoding_config_styleby import VisualEncodingConfigStyleby
 from .webhook_connection import WebhookConnection
 from .worker_task_response import WorkerTaskResponse
+from .worker_task_stats import WorkerTaskStats
+from .worker_task_stats_by_status import WorkerTaskStatsByStatus
+from .worker_task_stats_by_type import WorkerTaskStatsByType
 from .worker_task_status import WorkerTaskStatus
 from .worker_task_type import WorkerTaskType
 from .workspace_download_response import WorkspaceDownloadResponse
@@ -477,6 +488,8 @@ __all__ = (
     "CreateTaskRequest",
     "CreateWebhookConnectionRequest",
     "CsvDatasetConfig",
+    "DailyRunStats",
+    "DailyTokenUsage",
     "Dashboard",
     "DashboardButtonWidget",
     "DashboardChartWidget",
@@ -617,6 +630,7 @@ __all__ = (
     "ProjectResourceChangedPayloadResourceType",
     "ProjectResponse",
     "ProjectSettings",
+    "ProjectUsageResponse",
     "PublicDashboardResponse",
     "PublicDashboardResponseFiltersType0Item",
     "RefreshDatasetPayload",
@@ -635,6 +649,7 @@ __all__ = (
     "RestoreStatusTypeDef",
     "ReviewIssueRequest",
     "Run",
+    "RunStats",
     "RunStatsResponse",
     "S3Connection",
     "S3ObjectContent",
@@ -678,11 +693,15 @@ __all__ = (
     "TaskModel",
     "TaskModelParameterSchemaType0",
     "TaskScenario",
+    "TaskStats",
+    "TaskStatsByScenario",
     "TokenBalance",
     "TokenPackage",
     "TokenPurchase",
     "TokenResponse",
     "TokenUsage",
+    "TokenUsageStats",
+    "TokenUsageStatsByModel",
     "TooltipConfig",
     "TooltipSeriesConfig",
     "TooltipSeriesConfigFormatType0",
@@ -719,6 +738,9 @@ __all__ = (
     "VisualEncodingConfigStylePaletteType0Item",
     "WebhookConnection",
     "WorkerTaskResponse",
+    "WorkerTaskStats",
+    "WorkerTaskStatsByStatus",
+    "WorkerTaskStatsByType",
     "WorkerTaskStatus",
     "WorkerTaskType",
     "WorkspaceDownloadResponse",

convexity_api_client-0.12.0.dev230/convexity_api_client/models/daily_run_stats.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="DailyRunStats")
+
+
+@_attrs_define
+class DailyRunStats:
+    """Run counts for a single day.
+
+    Attributes:
+        date (str):
+        total (int):
+        completed (int):
+        failed (int):
+    """
+
+    date: str
+    total: int
+    completed: int
+    failed: int
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        date = self.date
+
+        total = self.total
+
+        completed = self.completed
+
+        failed = self.failed
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "date": date,
+                "total": total,
+                "completed": completed,
+                "failed": failed,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        date = d.pop("date")
+
+        total = d.pop("total")
+
+        completed = d.pop("completed")
+
+        failed = d.pop("failed")
+
+        daily_run_stats = cls(
+            date=date,
+            total=total,
+            completed=completed,
+            failed=failed,
+        )
+
+        daily_run_stats.additional_properties = d
+        return daily_run_stats
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

convexity_api_client-0.12.0.dev230/convexity_api_client/models/daily_token_usage.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="DailyTokenUsage")
+
+
+@_attrs_define
+class DailyTokenUsage:
+    """Token usage for a single day.
+
+    Attributes:
+        date (str):
+        tokens (int):
+        operations (int):
+    """
+
+    date: str
+    tokens: int
+    operations: int
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        date = self.date
+
+        tokens = self.tokens
+
+        operations = self.operations
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "date": date,
+                "tokens": tokens,
+                "operations": operations,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        date = d.pop("date")
+
+        tokens = d.pop("tokens")
+
+        operations = d.pop("operations")
+
+        daily_token_usage = cls(
+            date=date,
+            tokens=tokens,
+            operations=operations,
+        )
+
+        daily_token_usage.additional_properties = d
+        return daily_token_usage
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

convexity_api_client-0.12.0.dev230/convexity_api_client/models/project_usage_response.py

@@ -0,0 +1,122 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.run_stats import RunStats
+    from ..models.task_stats import TaskStats
+    from ..models.token_usage_stats import TokenUsageStats
+    from ..models.worker_task_stats import WorkerTaskStats
+
+
+T = TypeVar("T", bound="ProjectUsageResponse")
+
+
+@_attrs_define
+class ProjectUsageResponse:
+    """Unified project resource usage overview.
+
+    Attributes:
+        project_id (str):
+        period_start (str): ISO-8601 start of the reporting period
+        period_end (str): ISO-8601 end of the reporting period
+        tokens (TokenUsageStats): Aggregated LLM token consumption for a project.
+        tasks (TaskStats): Aggregated task definitions for a project.
+        runs (RunStats): Aggregated run execution metrics for a project.
+        worker_tasks (WorkerTaskStats): Background worker task metrics for a project.
+    """
+
+    project_id: str
+    period_start: str
+    period_end: str
+    tokens: TokenUsageStats
+    tasks: TaskStats
+    runs: RunStats
+    worker_tasks: WorkerTaskStats
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        project_id = self.project_id
+
+        period_start = self.period_start
+
+        period_end = self.period_end
+
+        tokens = self.tokens.to_dict()
+
+        tasks = self.tasks.to_dict()
+
+        runs = self.runs.to_dict()
+
+        worker_tasks = self.worker_tasks.to_dict()
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "project_id": project_id,
+                "period_start": period_start,
+                "period_end": period_end,
+                "tokens": tokens,
+                "tasks": tasks,
+                "runs": runs,
+                "worker_tasks": worker_tasks,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.run_stats import RunStats
+        from ..models.task_stats import TaskStats
+        from ..models.token_usage_stats import TokenUsageStats
+        from ..models.worker_task_stats import WorkerTaskStats
+
+        d = dict(src_dict)
+        project_id = d.pop("project_id")
+
+        period_start = d.pop("period_start")
+
+        period_end = d.pop("period_end")
+
+        tokens = TokenUsageStats.from_dict(d.pop("tokens"))
+
+        tasks = TaskStats.from_dict(d.pop("tasks"))
+
+        runs = RunStats.from_dict(d.pop("runs"))
+
+        worker_tasks = WorkerTaskStats.from_dict(d.pop("worker_tasks"))
+
+        project_usage_response = cls(
+            project_id=project_id,
+            period_start=period_start,
+            period_end=period_end,
+            tokens=tokens,
+            tasks=tasks,
+            runs=runs,
+            worker_tasks=worker_tasks,
+        )
+
+        project_usage_response.additional_properties = d
+        return project_usage_response
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties