robosystems-client 0.2.11__py3-none-any.whl → 0.2.13__py3-none-any.whl

robosystems_client/api/org_usage/get_org_usage.py

@@ -0,0 +1,186 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.http_validation_error import HTTPValidationError
+from ...models.org_usage_response import OrgUsageResponse
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+  org_id: str,
+  *,
+  days: Union[Unset, int] = 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": f"/v1/orgs/{org_id}/usage",
+    "params": params,
+  }
+
+  return _kwargs
+
+
+def _parse_response(
+  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[HTTPValidationError, OrgUsageResponse]]:
+  if response.status_code == 200:
+    response_200 = OrgUsageResponse.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: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[HTTPValidationError, OrgUsageResponse]]:
+  return Response(
+    status_code=HTTPStatus(response.status_code),
+    content=response.content,
+    headers=response.headers,
+    parsed=_parse_response(client=client, response=response),
+  )
+
+
+def sync_detailed(
+  org_id: str,
+  *,
+  client: AuthenticatedClient,
+  days: Union[Unset, int] = 30,
+) -> Response[Union[HTTPValidationError, OrgUsageResponse]]:
+  """Get Organization Usage
+
+   Get detailed usage statistics for an organization aggregated across all graphs.
+
+  Args:
+      org_id (str):
+      days (Union[Unset, int]):  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[Union[HTTPValidationError, OrgUsageResponse]]
+  """
+
+  kwargs = _get_kwargs(
+    org_id=org_id,
+    days=days,
+  )
+
+  response = client.get_httpx_client().request(
+    **kwargs,
+  )
+
+  return _build_response(client=client, response=response)
+
+
+def sync(
+  org_id: str,
+  *,
+  client: AuthenticatedClient,
+  days: Union[Unset, int] = 30,
+) -> Optional[Union[HTTPValidationError, OrgUsageResponse]]:
+  """Get Organization Usage
+
+   Get detailed usage statistics for an organization aggregated across all graphs.
+
+  Args:
+      org_id (str):
+      days (Union[Unset, int]):  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:
+      Union[HTTPValidationError, OrgUsageResponse]
+  """
+
+  return sync_detailed(
+    org_id=org_id,
+    client=client,
+    days=days,
+  ).parsed
+
+
+async def asyncio_detailed(
+  org_id: str,
+  *,
+  client: AuthenticatedClient,
+  days: Union[Unset, int] = 30,
+) -> Response[Union[HTTPValidationError, OrgUsageResponse]]:
+  """Get Organization Usage
+
+   Get detailed usage statistics for an organization aggregated across all graphs.
+
+  Args:
+      org_id (str):
+      days (Union[Unset, int]):  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[Union[HTTPValidationError, OrgUsageResponse]]
+  """
+
+  kwargs = _get_kwargs(
+    org_id=org_id,
+    days=days,
+  )
+
+  response = await client.get_async_httpx_client().request(**kwargs)
+
+  return _build_response(client=client, response=response)
+
+
+async def asyncio(
+  org_id: str,
+  *,
+  client: AuthenticatedClient,
+  days: Union[Unset, int] = 30,
+) -> Optional[Union[HTTPValidationError, OrgUsageResponse]]:
+  """Get Organization Usage
+
+   Get detailed usage statistics for an organization aggregated across all graphs.
+
+  Args:
+      org_id (str):
+      days (Union[Unset, int]):  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:
+      Union[HTTPValidationError, OrgUsageResponse]
+  """
+
+  return (
+    await asyncio_detailed(
+      org_id=org_id,
+      client=client,
+      days=days,
+    )
+  ).parsed

robosystems_client/api/service_offerings/get_service_offerings.py

@@ -61,9 +61,15 @@ def sync_detailed(
   and shared repository subscriptions. This is the primary endpoint for frontend
   applications to display subscription options.
 
+  **Pricing Model:**
+  - Graph subscriptions are **per-graph** with infrastructure-based pricing
+  - Each graph you create has its own monthly subscription
+  - Organizations can have multiple graphs with different infrastructure tiers
+  - Credits are allocated per-graph, not shared across organization
+
   Includes:
-  - Graph subscription tiers (standard, enterprise, premium)
-  - Shared repository subscriptions (SEC, industry, economic data)
+  - Graph infrastructure tiers (kuzu-standard, kuzu-large, kuzu-xlarge) - per-graph pricing
+  - Shared repository subscriptions (SEC, industry, economic data) - org-level
   - Operation costs and credit information
   - Features and capabilities for each tier
   - Enabled/disabled status for repositories
@@ -101,9 +107,15 @@ def sync(
   and shared repository subscriptions. This is the primary endpoint for frontend
   applications to display subscription options.
 
+  **Pricing Model:**
+  - Graph subscriptions are **per-graph** with infrastructure-based pricing
+  - Each graph you create has its own monthly subscription
+  - Organizations can have multiple graphs with different infrastructure tiers
+  - Credits are allocated per-graph, not shared across organization
+
   Includes:
-  - Graph subscription tiers (standard, enterprise, premium)
-  - Shared repository subscriptions (SEC, industry, economic data)
+  - Graph infrastructure tiers (kuzu-standard, kuzu-large, kuzu-xlarge) - per-graph pricing
+  - Shared repository subscriptions (SEC, industry, economic data) - org-level
   - Operation costs and credit information
   - Features and capabilities for each tier
   - Enabled/disabled status for repositories
@@ -137,9 +149,15 @@ async def asyncio_detailed(
   and shared repository subscriptions. This is the primary endpoint for frontend
   applications to display subscription options.
 
+  **Pricing Model:**
+  - Graph subscriptions are **per-graph** with infrastructure-based pricing
+  - Each graph you create has its own monthly subscription
+  - Organizations can have multiple graphs with different infrastructure tiers
+  - Credits are allocated per-graph, not shared across organization
+
   Includes:
-  - Graph subscription tiers (standard, enterprise, premium)
-  - Shared repository subscriptions (SEC, industry, economic data)
+  - Graph infrastructure tiers (kuzu-standard, kuzu-large, kuzu-xlarge) - per-graph pricing
+  - Shared repository subscriptions (SEC, industry, economic data) - org-level
   - Operation costs and credit information
   - Features and capabilities for each tier
   - Enabled/disabled status for repositories
@@ -175,9 +193,15 @@ async def asyncio(
   and shared repository subscriptions. This is the primary endpoint for frontend
   applications to display subscription options.
 
+  **Pricing Model:**
+  - Graph subscriptions are **per-graph** with infrastructure-based pricing
+  - Each graph you create has its own monthly subscription
+  - Organizations can have multiple graphs with different infrastructure tiers
+  - Credits are allocated per-graph, not shared across organization
+
   Includes:
-  - Graph subscription tiers (standard, enterprise, premium)
-  - Shared repository subscriptions (SEC, industry, economic data)
+  - Graph infrastructure tiers (kuzu-standard, kuzu-large, kuzu-xlarge) - per-graph pricing
+  - Shared repository subscriptions (SEC, industry, economic data) - org-level
   - Operation costs and credit information
   - Features and capabilities for each tier
   - Enabled/disabled status for repositories

robosystems_client/api/usage/get_graph_usage_analytics.py

@@ -95,7 +95,7 @@ def sync_detailed(
 ) -> Response[Union[ErrorResponse, GraphUsageResponse, HTTPValidationError]]:
   """Get Graph Usage Analytics
 
-   Get comprehensive usage analytics tracked by the GraphUsageTracking model.
+   Get comprehensive usage analytics tracked by the GraphUsage model.
 
   Provides temporal usage patterns including:
   - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)
@@ -171,7 +171,7 @@ def sync(
 ) -> Optional[Union[ErrorResponse, GraphUsageResponse, HTTPValidationError]]:
   """Get Graph Usage Analytics
 
-   Get comprehensive usage analytics tracked by the GraphUsageTracking model.
+   Get comprehensive usage analytics tracked by the GraphUsage model.
 
   Provides temporal usage patterns including:
   - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)
@@ -242,7 +242,7 @@ async def asyncio_detailed(
 ) -> Response[Union[ErrorResponse, GraphUsageResponse, HTTPValidationError]]:
   """Get Graph Usage Analytics
 
-   Get comprehensive usage analytics tracked by the GraphUsageTracking model.
+   Get comprehensive usage analytics tracked by the GraphUsage model.
 
   Provides temporal usage patterns including:
   - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)
@@ -316,7 +316,7 @@ async def asyncio(
 ) -> Optional[Union[ErrorResponse, GraphUsageResponse, HTTPValidationError]]:
   """Get Graph Usage Analytics
 
-   Get comprehensive usage analytics tracked by the GraphUsageTracking model.
+   Get comprehensive usage analytics tracked by the GraphUsage model.
 
   Provides temporal usage patterns including:
   - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)

robosystems_client/extensions/__init__.py

@@ -14,6 +14,14 @@ from .query_client import (
   QueryOptions,
   QueuedQueryError,
 )
+from .agent_client import (
+  AgentClient,
+  AgentResult,
+  QueuedAgentResponse,
+  AgentQueryRequest,
+  AgentOptions,
+  QueuedAgentError,
+)
 from .operation_client import (
   OperationClient,
   OperationStatus,
@@ -118,6 +126,13 @@ __all__ = [
   "QueryRequest",
   "QueryOptions",
   "QueuedQueryError",
+  # Agent Client
+  "AgentClient",
+  "AgentResult",
+  "QueuedAgentResponse",
+  "AgentQueryRequest",
+  "AgentOptions",
+  "QueuedAgentError",
   # Operation Client
   "OperationClient",
   "OperationStatus",
@@ -189,6 +204,16 @@ def stream_query(graph_id: str, query: str, parameters=None, chunk_size=None):
   return extensions.query.stream_query(graph_id, query, parameters, chunk_size)
 
 
+def agent_query(graph_id: str, message: str, context=None):
+  """Execute an agent query using the default extensions instance"""
+  return extensions.agent.query(graph_id, message, context)
+
+
+def analyze_financials(graph_id: str, message: str, on_progress=None):
+  """Execute financial agent using the default extensions instance"""
+  return extensions.agent.analyze_financials(graph_id, message, on_progress)
+
+
 # DataFrame convenience functions (if pandas is available)
 if (
   HAS_PANDAS