roark-analytics 7.2.0__tar.gz → 7.3.0__tar.gz

roark_analytics-7.3.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "7.3.0"
+}

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [7.3.0](https://github.com/roarkhq/sdk-roark-analytics-python/compare/v7.2.0...v7.3.0) (2026-10-21)
+
+
+### Features
+
+* **api:** api update ([#662](https://github.com/roarkhq/sdk-roark-analytics-python/issues/662)) ([f9ea4a1](https://github.com/roarkhq/sdk-roark-analytics-python/commit/f9ea4a1fd5e3a142d2a17cd0dcaee5892393eb1f))
+
+
+### Chores
+
+* fold next into main ([c700bdc](https://github.com/roarkhq/sdk-roark-analytics-python/commit/c700bdcc8ed04161bda8e617b1741cc30803fa8f))
+
 ## [7.2.0](https://github.com/roarkhq/sdk-roark-analytics-python/compare/v7.1.0...v7.2.0) (2026-10-21)
 
 

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: roark_analytics
-Version: 7.2.0
+Version: 7.3.0
 Summary: The official Python library for the roark API
 Project-URL: Homepage, https://github.com/roarkhq/sdk-roark-analytics-python
 Project-URL: Repository, https://github.com/roarkhq/sdk-roark-analytics-python

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/api.md

@@ -64,6 +64,7 @@ from roark_analytics.types import (
     CallListResponse,
     CallAppendToolInvocationsResponse,
     CallGetByIDResponse,
+    CallGetCostResponse,
     CallGetTranscriptResponse,
     CallListMetricsResponse,
     CallListSentimentRunsResponse,
@@ -77,6 +78,7 @@ Methods:
 - <code title="get /v1/call">client.call.<a href="./src/roark_analytics/resources/call.py">list</a>(\*\*<a href="src/roark_analytics/types/call_list_params.py">params</a>) -> <a href="./src/roark_analytics/types/call_list_response.py">CallListResponse</a></code>
 - <code title="post /v1/call/{callId}/tool-invocations">client.call.<a href="./src/roark_analytics/resources/call.py">append_tool_invocations</a>(call_id, \*\*<a href="src/roark_analytics/types/call_append_tool_invocations_params.py">params</a>) -> <a href="./src/roark_analytics/types/call_append_tool_invocations_response.py">CallAppendToolInvocationsResponse</a></code>
 - <code title="get /v1/call/{callId}">client.call.<a href="./src/roark_analytics/resources/call.py">get_by_id</a>(call_id) -> <a href="./src/roark_analytics/types/call_get_by_id_response.py">CallGetByIDResponse</a></code>
+- <code title="get /v1/call/{callId}/cost">client.call.<a href="./src/roark_analytics/resources/call.py">get_cost</a>(call_id) -> <a href="./src/roark_analytics/types/call_get_cost_response.py">CallGetCostResponse</a></code>
 - <code title="get /v1/call/{callId}/transcript">client.call.<a href="./src/roark_analytics/resources/call.py">get_transcript</a>(call_id, \*\*<a href="src/roark_analytics/types/call_get_transcript_params.py">params</a>) -> <a href="./src/roark_analytics/types/call_get_transcript_response.py">CallGetTranscriptResponse</a></code>
 - <code title="get /v1/call/{callId}/metrics">client.call.<a href="./src/roark_analytics/resources/call.py">list_metrics</a>(call_id, \*\*<a href="src/roark_analytics/types/call_list_metrics_params.py">params</a>) -> <a href="./src/roark_analytics/types/call_list_metrics_response.py">CallListMetricsResponse</a></code>
 - <code title="get /v1/call/{callId}/sentiment-run">client.call.<a href="./src/roark_analytics/resources/call.py">list_sentiment_runs</a>(call_id) -> <a href="./src/roark_analytics/types/call_list_sentiment_runs_response.py">CallListSentimentRunsResponse</a></code>
@@ -343,6 +345,7 @@ from roark_analytics.types import (
     SimulationRunPlanJobCancelResponse,
     SimulationRunPlanJobCreateDebriefResponse,
     SimulationRunPlanJobGetByIDResponse,
+    SimulationRunPlanJobGetCostResponse,
     SimulationRunPlanJobGetResultsResponse,
     SimulationRunPlanJobStartResponse,
 )
@@ -354,6 +357,7 @@ Methods:
 - <code title="post /v1/simulation/plan/job/{jobId}/cancel">client.simulation_run_plan_job.<a href="./src/roark_analytics/resources/simulation_run_plan_job.py">cancel</a>(job_id) -> <a href="./src/roark_analytics/types/simulation_run_plan_job_cancel_response.py">SimulationRunPlanJobCancelResponse</a></code>
 - <code title="post /v1/simulation/plan/job/{jobId}/debrief">client.simulation_run_plan_job.<a href="./src/roark_analytics/resources/simulation_run_plan_job.py">create_debrief</a>(job_id, \*\*<a href="src/roark_analytics/types/simulation_run_plan_job_create_debrief_params.py">params</a>) -> <a href="./src/roark_analytics/types/simulation_run_plan_job_create_debrief_response.py">SimulationRunPlanJobCreateDebriefResponse</a></code>
 - <code title="get /v1/simulation/plan/job/{jobId}">client.simulation_run_plan_job.<a href="./src/roark_analytics/resources/simulation_run_plan_job.py">get_by_id</a>(job_id) -> <a href="./src/roark_analytics/types/simulation_run_plan_job_get_by_id_response.py">SimulationRunPlanJobGetByIDResponse</a></code>
+- <code title="get /v1/simulation/plan/job/{jobId}/cost">client.simulation_run_plan_job.<a href="./src/roark_analytics/resources/simulation_run_plan_job.py">get_cost</a>(job_id) -> <a href="./src/roark_analytics/types/simulation_run_plan_job_get_cost_response.py">SimulationRunPlanJobGetCostResponse</a></code>
 - <code title="get /v1/simulation/plan/job/{jobId}/results">client.simulation_run_plan_job.<a href="./src/roark_analytics/resources/simulation_run_plan_job.py">get_results</a>(job_id, \*\*<a href="src/roark_analytics/types/simulation_run_plan_job_get_results_params.py">params</a>) -> <a href="./src/roark_analytics/types/simulation_run_plan_job_get_results_response.py">SimulationRunPlanJobGetResultsResponse</a></code>
 - <code title="post /v1/simulation/plan/{planId}/job">client.simulation_run_plan_job.<a href="./src/roark_analytics/resources/simulation_run_plan_job.py">start</a>(plan_id, \*\*<a href="src/roark_analytics/types/simulation_run_plan_job_start_params.py">params</a>) -> <a href="./src/roark_analytics/types/simulation_run_plan_job_start_response.py">SimulationRunPlanJobStartResponse</a></code>
 

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "roark_analytics"
-version = "7.2.0"
+version = "7.3.0"
 description = "The official Python library for the roark API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/src/roark_analytics/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "roark_analytics"
-__version__ = "7.2.0"  # x-release-please-version
+__version__ = "7.3.0"  # x-release-please-version

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/src/roark_analytics/resources/call.py

@@ -28,6 +28,7 @@ from .._response import (
 from .._base_client import make_request_options
 from ..types.call_list_response import CallListResponse
 from ..types.call_create_response import CallCreateResponse
+from ..types.call_get_cost_response import CallGetCostResponse
 from ..types.call_get_by_id_response import CallGetByIDResponse
 from ..types.call_list_metrics_response import CallListMetricsResponse
 from ..types.call_get_transcript_response import CallGetTranscriptResponse
@@ -382,6 +383,43 @@ class CallResource(SyncAPIResource):
             cast_to=CallGetByIDResponse,
         )
 
+    def get_cost(
+        self,
+        call_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> CallGetCostResponse:
+        """
+        The billable spend attributed to one call, split by cost type, with every cost
+        line behind it. Simulated calls include the costs their simulation incurred
+        before the call connected. Amounts are billable spend only, in exact
+        micro-dollars (`*UsdMicros`) and dollars (`*Usd`, for display). Requires an API
+        key with the `billing:read` permission.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not call_id:
+            raise ValueError(f"Expected a non-empty value for `call_id` but received {call_id!r}")
+        return self._get(
+            f"/v1/call/{call_id}/cost",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=CallGetCostResponse,
+        )
+
     def get_transcript(
         self,
         call_id: str,
@@ -930,6 +968,43 @@ class AsyncCallResource(AsyncAPIResource):
             cast_to=CallGetByIDResponse,
         )
 
+    async def get_cost(
+        self,
+        call_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> CallGetCostResponse:
+        """
+        The billable spend attributed to one call, split by cost type, with every cost
+        line behind it. Simulated calls include the costs their simulation incurred
+        before the call connected. Amounts are billable spend only, in exact
+        micro-dollars (`*UsdMicros`) and dollars (`*Usd`, for display). Requires an API
+        key with the `billing:read` permission.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not call_id:
+            raise ValueError(f"Expected a non-empty value for `call_id` but received {call_id!r}")
+        return await self._get(
+            f"/v1/call/{call_id}/cost",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=CallGetCostResponse,
+        )
+
     async def get_transcript(
         self,
         call_id: str,
@@ -1152,6 +1227,9 @@ class CallResourceWithRawResponse:
         self.get_by_id = to_raw_response_wrapper(
             call.get_by_id,
         )
+        self.get_cost = to_raw_response_wrapper(
+            call.get_cost,
+        )
         self.get_transcript = to_raw_response_wrapper(
             call.get_transcript,
         )
@@ -1182,6 +1260,9 @@ class AsyncCallResourceWithRawResponse:
         self.get_by_id = async_to_raw_response_wrapper(
             call.get_by_id,
         )
+        self.get_cost = async_to_raw_response_wrapper(
+            call.get_cost,
+        )
         self.get_transcript = async_to_raw_response_wrapper(
             call.get_transcript,
         )
@@ -1212,6 +1293,9 @@ class CallResourceWithStreamingResponse:
         self.get_by_id = to_streamed_response_wrapper(
             call.get_by_id,
         )
+        self.get_cost = to_streamed_response_wrapper(
+            call.get_cost,
+        )
         self.get_transcript = to_streamed_response_wrapper(
             call.get_transcript,
         )
@@ -1242,6 +1326,9 @@ class AsyncCallResourceWithStreamingResponse:
         self.get_by_id = async_to_streamed_response_wrapper(
             call.get_by_id,
         )
+        self.get_cost = async_to_streamed_response_wrapper(
+            call.get_cost,
+        )
         self.get_transcript = async_to_streamed_response_wrapper(
             call.get_transcript,
         )

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/src/roark_analytics/resources/simulation_run_plan_job.py

@@ -27,6 +27,7 @@ from .._base_client import make_request_options
 from ..types.simulation_run_plan_job_list_response import SimulationRunPlanJobListResponse
 from ..types.simulation_run_plan_job_start_response import SimulationRunPlanJobStartResponse
 from ..types.simulation_run_plan_job_cancel_response import SimulationRunPlanJobCancelResponse
+from ..types.simulation_run_plan_job_get_cost_response import SimulationRunPlanJobGetCostResponse
 from ..types.simulation_run_plan_job_get_by_id_response import SimulationRunPlanJobGetByIDResponse
 from ..types.simulation_run_plan_job_get_results_response import SimulationRunPlanJobGetResultsResponse
 from ..types.simulation_run_plan_job_create_debrief_response import SimulationRunPlanJobCreateDebriefResponse
@@ -252,6 +253,43 @@ class SimulationRunPlanJobResource(SyncAPIResource):
             cast_to=SimulationRunPlanJobGetByIDResponse,
         )
 
+    def get_cost(
+        self,
+        job_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SimulationRunPlanJobGetCostResponse:
+        """
+        The billable spend for one simulation run (run plan job), split by cost type,
+        with the spend of each simulated call in it. Safe to call while the run is in
+        progress: totals reflect the costs recorded so far. Amounts are billable spend
+        only, in exact micro-dollars (`*UsdMicros`) and dollars (`*Usd`, for display).
+        Requires an API key with the `billing:read` permission.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not job_id:
+            raise ValueError(f"Expected a non-empty value for `job_id` but received {job_id!r}")
+        return self._get(
+            f"/v1/simulation/plan/job/{job_id}/cost",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SimulationRunPlanJobGetCostResponse,
+        )
+
     def get_results(
         self,
         job_id: str,
@@ -586,6 +624,43 @@ class AsyncSimulationRunPlanJobResource(AsyncAPIResource):
             cast_to=SimulationRunPlanJobGetByIDResponse,
         )
 
+    async def get_cost(
+        self,
+        job_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SimulationRunPlanJobGetCostResponse:
+        """
+        The billable spend for one simulation run (run plan job), split by cost type,
+        with the spend of each simulated call in it. Safe to call while the run is in
+        progress: totals reflect the costs recorded so far. Amounts are billable spend
+        only, in exact micro-dollars (`*UsdMicros`) and dollars (`*Usd`, for display).
+        Requires an API key with the `billing:read` permission.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not job_id:
+            raise ValueError(f"Expected a non-empty value for `job_id` but received {job_id!r}")
+        return await self._get(
+            f"/v1/simulation/plan/job/{job_id}/cost",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SimulationRunPlanJobGetCostResponse,
+        )
+
     async def get_results(
         self,
         job_id: str,
@@ -718,6 +793,9 @@ class SimulationRunPlanJobResourceWithRawResponse:
         self.get_by_id = to_raw_response_wrapper(
             simulation_run_plan_job.get_by_id,
         )
+        self.get_cost = to_raw_response_wrapper(
+            simulation_run_plan_job.get_cost,
+        )
         self.get_results = to_raw_response_wrapper(
             simulation_run_plan_job.get_results,
         )
@@ -742,6 +820,9 @@ class AsyncSimulationRunPlanJobResourceWithRawResponse:
         self.get_by_id = async_to_raw_response_wrapper(
             simulation_run_plan_job.get_by_id,
         )
+        self.get_cost = async_to_raw_response_wrapper(
+            simulation_run_plan_job.get_cost,
+        )
         self.get_results = async_to_raw_response_wrapper(
             simulation_run_plan_job.get_results,
         )
@@ -766,6 +847,9 @@ class SimulationRunPlanJobResourceWithStreamingResponse:
         self.get_by_id = to_streamed_response_wrapper(
             simulation_run_plan_job.get_by_id,
         )
+        self.get_cost = to_streamed_response_wrapper(
+            simulation_run_plan_job.get_cost,
+        )
         self.get_results = to_streamed_response_wrapper(
             simulation_run_plan_job.get_results,
         )
@@ -790,6 +874,9 @@ class AsyncSimulationRunPlanJobResourceWithStreamingResponse:
         self.get_by_id = async_to_streamed_response_wrapper(
             simulation_run_plan_job.get_by_id,
         )
+        self.get_cost = async_to_streamed_response_wrapper(
+            simulation_run_plan_job.get_cost,
+        )
         self.get_results = async_to_streamed_response_wrapper(
             simulation_run_plan_job.get_results,
         )

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/src/roark_analytics/resources/usage.py

@@ -58,8 +58,10 @@ class UsageResource(SyncAPIResource):
         Report billable usage and cost for the organization over a time window, broken
         down by project (highest spend first). Pass `from`/`to` as ISO 8601 timestamps;
         optionally pass `projectId` to scope the report to one project. Amounts are
-        billable spend only (what we absorb is never included). Authenticated by an
-        organization API key with the `usage:read` permission.
+        billable spend only (what we absorb is never included). Authenticated by either
+        an organization API key with the `usage:read` permission (any project in the
+        organization), or a project API key with the `billing:read` permission (that
+        key's own project only; any other `projectId` is a 403).
 
         Args:
           from_: Start of the window (inclusive), ISO 8601.
@@ -134,8 +136,10 @@ class AsyncUsageResource(AsyncAPIResource):
         Report billable usage and cost for the organization over a time window, broken
         down by project (highest spend first). Pass `from`/`to` as ISO 8601 timestamps;
         optionally pass `projectId` to scope the report to one project. Amounts are
-        billable spend only (what we absorb is never included). Authenticated by an
-        organization API key with the `usage:read` permission.
+        billable spend only (what we absorb is never included). Authenticated by either
+        an organization API key with the `usage:read` permission (any project in the
+        organization), or a project API key with the `billing:read` permission (that
+        key's own project only; any other `projectId` is a 403).
 
         Args:
           from_: Start of the window (inclusive), ISO 8601.

{roark_analytics-7.2.0 → roark_analytics-7.3.0}/src/roark_analytics/types/__init__.py

@@ -34,6 +34,7 @@ from .simulation_run_params import SimulationRunParams as SimulationRunParams
 from .webhook_create_params import WebhookCreateParams as WebhookCreateParams
 from .webhook_list_response import WebhookListResponse as WebhookListResponse
 from .analytics_query_params import AnalyticsQueryParams as AnalyticsQueryParams
+from .call_get_cost_response import CallGetCostResponse as CallGetCostResponse
 from .config_flow_step_param import ConfigFlowStepParam as ConfigFlowStepParam
 from .call_get_by_id_response import CallGetByIDResponse as CallGetByIDResponse
 from .dashboard_create_params import DashboardCreateParams as DashboardCreateParams
@@ -294,6 +295,9 @@ from .metric_collection_job_get_by_id_response import (
 from .simulation_environment_get_by_id_response import (
     SimulationEnvironmentGetByIDResponse as SimulationEnvironmentGetByIDResponse,
 )
+from .simulation_run_plan_job_get_cost_response import (
+    SimulationRunPlanJobGetCostResponse as SimulationRunPlanJobGetCostResponse,
+)
 from .benchmark_list_target_score_samples_params import (
     BenchmarkListTargetScoreSamplesParams as BenchmarkListTargetScoreSamplesParams,
 )

roark_analytics-7.3.0/src/roark_analytics/types/call_get_cost_response.py

@@ -0,0 +1,105 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["CallGetCostResponse", "Data", "DataBreakdown", "DataItem"]
+
+
+class DataBreakdown(BaseModel):
+    amount_usd: float = FieldInfo(alias="amountUsd")
+    """The same figure in US dollars."""
+
+    amount_usd_micros: int = FieldInfo(alias="amountUsdMicros")
+    """Billable spend for this type, in micro-dollars."""
+
+    quantity: float
+    """Units billed (see the line items for the unit)."""
+
+    source: Literal[
+        "SIM_PLATFORM_FEE",
+        "SIM_TTS",
+        "SIM_STT",
+        "SIM_LLM",
+        "SIM_TELEPHONY",
+        "METRIC",
+        "TRANSCRIPTION",
+        "INTERNAL_LLM",
+        "INTERNAL_STT",
+    ]
+    """The cost source, e.g. SIM_PLATFORM_FEE, SIM_LLM, METRIC."""
+
+    surface: Literal["SIMULATION", "POST_CALL"]
+    """SIMULATION or POST_CALL."""
+
+
+class DataItem(BaseModel):
+    amount_usd: float = FieldInfo(alias="amountUsd")
+
+    amount_usd_micros: int = FieldInfo(alias="amountUsdMicros")
+
+    event_id: str = FieldInfo(alias="eventId")
+    """Stable id of the cost event. Use it to deduplicate."""
+
+    metric_collection_job_id: Optional[str] = FieldInfo(alias="metricCollectionJobId")
+    """
+    The grading pass a METRIC line paid for. A call graded twice carries one line
+    per pass.
+    """
+
+    metric_definition_id: Optional[str] = FieldInfo(alias="metricDefinitionId")
+    """The metric a METRIC line was charged for."""
+
+    model: Optional[str]
+
+    occurred_at: str = FieldInfo(alias="occurredAt")
+    """When the cost was incurred, ISO 8601."""
+
+    provider: Optional[str]
+
+    quantity: float
+
+    quantity_unit: Literal["MINUTES", "INPUT_TOKENS", "OUTPUT_TOKENS", "CHARACTERS", "AUDIO_SECONDS", "UNITS"] = (
+        FieldInfo(alias="quantityUnit")
+    )
+
+    simulation_job_id: Optional[str] = FieldInfo(alias="simulationJobId")
+
+    source: Literal[
+        "SIM_PLATFORM_FEE",
+        "SIM_TTS",
+        "SIM_STT",
+        "SIM_LLM",
+        "SIM_TELEPHONY",
+        "METRIC",
+        "TRANSCRIPTION",
+        "INTERNAL_LLM",
+        "INTERNAL_STT",
+    ]
+
+    surface: Literal["SIMULATION", "POST_CALL"]
+
+
+class Data(BaseModel):
+    breakdown: List[DataBreakdown]
+    """Spend by cost type. Sums to totalUsdMicros."""
+
+    call_id: str = FieldInfo(alias="callId")
+
+    currency: Literal["usd"]
+
+    items: List[DataItem]
+    """Every billable cost line attributed to the call."""
+
+    total_usd: float = FieldInfo(alias="totalUsd")
+
+    total_usd_micros: int = FieldInfo(alias="totalUsdMicros")
+    """Total billable spend for this call, in micro-dollars."""
+
+
+class CallGetCostResponse(BaseModel):
+    data: Data

roark_analytics-7.3.0/src/roark_analytics/types/simulation_run_plan_job_get_cost_response.py

@@ -0,0 +1,75 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["SimulationRunPlanJobGetCostResponse", "Data", "DataBreakdown", "DataCall"]
+
+
+class DataBreakdown(BaseModel):
+    amount_usd: float = FieldInfo(alias="amountUsd")
+    """The same figure in US dollars."""
+
+    amount_usd_micros: int = FieldInfo(alias="amountUsdMicros")
+    """Billable spend for this type, in micro-dollars."""
+
+    quantity: float
+    """Units billed (see the line items for the unit)."""
+
+    source: Literal[
+        "SIM_PLATFORM_FEE",
+        "SIM_TTS",
+        "SIM_STT",
+        "SIM_LLM",
+        "SIM_TELEPHONY",
+        "METRIC",
+        "TRANSCRIPTION",
+        "INTERNAL_LLM",
+        "INTERNAL_STT",
+    ]
+    """The cost source, e.g. SIM_PLATFORM_FEE, SIM_LLM, METRIC."""
+
+    surface: Literal["SIMULATION", "POST_CALL"]
+    """SIMULATION or POST_CALL."""
+
+
+class DataCall(BaseModel):
+    amount_usd: float = FieldInfo(alias="amountUsd")
+
+    amount_usd_micros: int = FieldInfo(alias="amountUsdMicros")
+
+    breakdown: List[DataBreakdown]
+
+    conversation_id: Optional[str] = FieldInfo(alias="conversationId")
+    """
+    The call (voice runs) or chat (chat runs) the spend is attributed to. Null for
+    costs incurred before the conversation existed; use simulationJobId to join
+    those.
+    """
+
+    simulation_job_id: Optional[str] = FieldInfo(alias="simulationJobId")
+
+
+class Data(BaseModel):
+    breakdown: List[DataBreakdown]
+    """Spend by cost type. Sums to totalUsdMicros."""
+
+    calls: List[DataCall]
+    """Spend per simulated call in the run."""
+
+    currency: Literal["usd"]
+
+    job_id: str = FieldInfo(alias="jobId")
+
+    total_usd: float = FieldInfo(alias="totalUsd")
+
+    total_usd_micros: int = FieldInfo(alias="totalUsdMicros")
+    """Total billable spend for the run, in micro-dollars."""
+
+
+class SimulationRunPlanJobGetCostResponse(BaseModel):
+    data: Data