@naturali/sdk 0.109.0 → 0.109.1

package/dist/index.d.cts

@@ -5416,13 +5416,13 @@ type UsageGroup = {
   cost_usd: number | null;
 } & UsageTokens & UsageComponents;
 /**
- * One page of buckets, one entry per distinct value in the chosen dimension. The rollup grows with the window — group_by=run buckets per generation — so the buckets are paged while total counts the whole window. Ordered by cost_usd descending, ties broken by key then ai_provider_id ascending, nulls last: the first page is the biggest spenders, and paging never repeats or skips a bucket.
+ * One page of buckets, one entry per distinct value in the chosen dimension. The rollup grows with the window — day buckets per day, model per model served — so the buckets are paged while total counts the whole window. Ordered by cost_usd descending, ties broken by key then ai_provider_id ascending, nulls last: the first page is the biggest spenders, and paging never repeats or skips a bucket.
  *
  */
 type ProjectUsageGroups = {
   data: Array<UsageGroup>;
   /**
-   * Distinct buckets in the window, independent of limit. This is the count a "how many runs this cycle" question reads — no page walk required.
+   * Distinct buckets in the window, independent of limit, including a null bucket for the events the chosen dimension does not apply to. It is a count of buckets and not of anything they describe: under group_by=run a project that runs no orchestration has exactly one bucket whatever its volume. How many runs an account made is GET /v1/users/me/usage.
    *
    */
   total: number;
@@ -15972,7 +15972,7 @@ type GetProjectUsageData = {
   };
   query?: {
     /**
-     * Dimension to bucket by. `day` buckets on the event's UTC calendar day; the others on the matching id. `model` buckets on the model *and* the provider that served it, so one model name served by two providers is two groups (see `ai_provider_id`). `ai_provider` buckets on the provider the spend was billed against — a routed generation's serving target, or the agent's pinned provider — which is the total a per-provider reconciliation wants, without summing the model dimension by hand.
+     * Dimension to bucket by. `day` buckets on the event's UTC calendar day; the others on the matching id. `model` buckets on the model *and* the provider that served it, so one model name served by two providers is two groups (see `ai_provider_id`). `ai_provider` buckets on the provider the spend was billed against — a routed generation's serving target, or the agent's pinned provider — which is the total a per-provider reconciliation wants, without summing the model dimension by hand. `run` buckets on the orchestration run an event belongs to; work that runs no orchestration collapses into the single null bucket, so the bucket count there is not a count of runs.
      *
      */
     group_by?: 'model' | 'ai_provider' | 'agent' | 'run' | 'day' | 'meter_type';

package/dist/index.d.mts

@@ -5416,13 +5416,13 @@ type UsageGroup = {
   cost_usd: number | null;
 } & UsageTokens & UsageComponents;
 /**
- * One page of buckets, one entry per distinct value in the chosen dimension. The rollup grows with the window — group_by=run buckets per generation — so the buckets are paged while total counts the whole window. Ordered by cost_usd descending, ties broken by key then ai_provider_id ascending, nulls last: the first page is the biggest spenders, and paging never repeats or skips a bucket.
+ * One page of buckets, one entry per distinct value in the chosen dimension. The rollup grows with the window — day buckets per day, model per model served — so the buckets are paged while total counts the whole window. Ordered by cost_usd descending, ties broken by key then ai_provider_id ascending, nulls last: the first page is the biggest spenders, and paging never repeats or skips a bucket.
  *
  */
 type ProjectUsageGroups = {
   data: Array<UsageGroup>;
   /**
-   * Distinct buckets in the window, independent of limit. This is the count a "how many runs this cycle" question reads — no page walk required.
+   * Distinct buckets in the window, independent of limit, including a null bucket for the events the chosen dimension does not apply to. It is a count of buckets and not of anything they describe: under group_by=run a project that runs no orchestration has exactly one bucket whatever its volume. How many runs an account made is GET /v1/users/me/usage.
    *
    */
   total: number;
@@ -15972,7 +15972,7 @@ type GetProjectUsageData = {
   };
   query?: {
     /**
-     * Dimension to bucket by. `day` buckets on the event's UTC calendar day; the others on the matching id. `model` buckets on the model *and* the provider that served it, so one model name served by two providers is two groups (see `ai_provider_id`). `ai_provider` buckets on the provider the spend was billed against — a routed generation's serving target, or the agent's pinned provider — which is the total a per-provider reconciliation wants, without summing the model dimension by hand.
+     * Dimension to bucket by. `day` buckets on the event's UTC calendar day; the others on the matching id. `model` buckets on the model *and* the provider that served it, so one model name served by two providers is two groups (see `ai_provider_id`). `ai_provider` buckets on the provider the spend was billed against — a routed generation's serving target, or the agent's pinned provider — which is the total a per-provider reconciliation wants, without summing the model dimension by hand. `run` buckets on the orchestration run an event belongs to; work that runs no orchestration collapses into the single null bucket, so the bucket count there is not a count of runs.
      *
      */
     group_by?: 'model' | 'ai_provider' | 'agent' | 'run' | 'day' | 'meter_type';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.109.0",
+  "version": "0.109.1",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.109.0"
+    "@naturali/api": "0.109.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",