infrawrench-sdk 1.66.0 → 1.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b12c3510f623aa61a1409b1430c1cafccf89a939221ec5cee7d35a51650a6f1
-  data.tar.gz: a7bb4f300419ad8a0456d5f5d55e6253d0022d2fa98057469b8324c87409061d
+  metadata.gz: 46cb020003e6f0ccd4c0df6c8eaa6941ace890215f3818597b2d3a188d151f7c
+  data.tar.gz: e392a0ed1b80a61ee7f0dc476c785ad97fc69ee6d58160f79ae402579fd808ee
 SHA512:
-  metadata.gz: 888eb1fb8fffd427d6646e6ab9f1b01f6e12234fbd163ed53a4555157d5dd53b08c2758924a3d458f19d1f154d3e96e7c128beb89986114974c66dd61527b050
-  data.tar.gz: e283026c7f55b494868da5f38ecc8f9d81019a325be0442a13ef414a15a14318fe11da077b512e4bf13847ef07b9fc76982819175967411d93f420953887d676
+  metadata.gz: dda0c71d25b1d8a63605f0bda392441bfaf6bf7037ea86bc241c2e445512612004db1f07cb6d8f64f04c34d7f23dfcefc2fb6b0f3f2585b311df1bd12a872c42
+  data.tar.gz: f0d91cee4b944347d3899857752f0a75d25927924e6bd0fddf99bf9611b0a94d031bad2f8a67400ddf4cb364cdd0fb78e0ad9c8bd33cd222da4e44af96256768

data/README.md

@@ -1,6 +1,6 @@
 # infrawrench-sdk
 
-Generated Ruby client for the Infrawrench API (API version `1.66.0`).
+Generated Ruby client for the Infrawrench API (API version `1.69.0`).
 
 **Do not edit this gem by hand** — it is regenerated from `openapi.json` and is
 not checked into the repository. Run
@@ -41,7 +41,7 @@ Every method takes an optional trailing `request_options:` hash (`:headers`,
 Responses are the plain `Hash`/`Array` that `JSON.parse` returns, with String
 keys spelled exactly as the wire spells them. There are no model classes — see
 [`sig/infrawrench/sdk.rbs`](./sig/infrawrench/sdk.rbs) for the shape of every one of the
-889 schemas, as RBS type aliases that steep and TypeProf can read.
+900 schemas, as RBS type aliases that steep and TypeProf can read.
 
 Non-2xx responses raise `Infrawrench::ApiError`, which carries `#status`,
 the parsed `#body`, and the machine-readable `#code` when the API sends one —

data/infrawrench-sdk.gemspec

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -17,8 +17,8 @@ require_relative "lib/infrawrench/version"
 Gem::Specification.new do |spec|
   spec.name = "infrawrench-sdk"
   spec.version = Infrawrench::VERSION
-  spec.summary = "Generated Ruby client for the Infrawrench API (v1.66.0)."
-  spec.description = "Generated Ruby client for the Infrawrench API (v1.66.0). Covers the published API surface only — operations marked x-internal in the spec are not generated. No runtime dependencies."
+  spec.summary = "Generated Ruby client for the Infrawrench API (v1.69.0)."
+  spec.description = "Generated Ruby client for the Infrawrench API (v1.69.0). Covers the published API surface only — operations marked x-internal in the spec are not generated. No runtime dependencies."
   spec.authors = ["Infrawrench LLC", "Astrid Gealer"]
   spec.email = ["astrid@infrawrench.com"]
   spec.homepage = "https://infrawrench.com/docs/team-and-billing/client-sdks"

data/lib/infrawrench/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -3673,6 +3673,31 @@ module Infrawrench
       )
     end
 
+    # List a metric's labels
+    #
+    # The label keys the metric's values carry, each with its distinct values
+    # (at most 500) and its cost mapping. A mapped label nobody has reported yet
+    # is listed with no values.
+    #
+    # GET /api/org/{orgId}/business-metrics/{id}/labels
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param id [String] Metric id or key
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `Hash` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def labels(id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/business-metrics/{id}/labels",
+        path_params: { "orgId" => org_id, "id" => id },
+        request_options: request_options
+      )
+    end
+
     # Query unit costs or margin
     #
     # Divide spend by the metric, bucketed as asked. Three properties of the
@@ -3687,9 +3712,11 @@ module Infrawrench
     # - **Currencies are never merged.** Spend in a currency with no stated rate
     # keeps its own series rather than being dropped or added to another.
     #
-    # There is no `groupBy`: a per-group ratio would need a per-group
-    # denominator, and dividing each service's spend by the whole customer count
-    # produces numbers that do not sum to the real one.
+    # There is no spend `groupBy`: a per-group ratio needs a per-group
+    # denominator. Split by a metric label with `groupByLabel` instead; in a
+    # ratio mode the label must be mapped to the cost dimension its values name
+    # (`labelMappings` on the metric), so each label value's spend is divided by
+    # its own volume.
     #
     # _Requires permission: `costs:read`._
     #
@@ -3750,6 +3777,57 @@ module Infrawrench
         request_options: request_options
       )
     end
+
+    # Query cost per usage unit
+    #
+    # Spend divided by the usage quantity providers report in one `usageUnit`,
+    # with no business metric involved. Both halves come from the same cost rows
+    # (those reported in that unit), so the numerator is exactly the spend that
+    # bought the denominator. A bucket with no usage is a gap (`no_usage`),
+    # never 0. Labels do not apply.
+    #
+    # POST /api/org/{orgId}/business-metrics/usage-unit-costs
+    #
+    # Raises on 400: Bad request
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash] Request body, shaped as `UnitCostQueryRequest`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `UnitCostQueryResponse` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def usage_unit_costs(body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/business-metrics/usage-unit-costs",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
+    # List usage units
+    #
+    # The provider usage units the organization's cost rows carry over the last
+    # 90 days, most spend first, with a few of the services reporting each.
+    # Backs the per-usage-unit picker.
+    #
+    # GET /api/org/{orgId}/business-metrics/usage-units
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `Hash` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def usage_units(org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/business-metrics/usage-units",
+        path_params: { "orgId" => org_id },
+        request_options: request_options
+      )
+    end
   end
 
   # `client.calendar.subscriptions`
@@ -7715,7 +7793,8 @@ module Infrawrench
     # @param to [String, nil] Defaults to today.
     # @param basis [String, nil] Which money to sum. `cash` (the default) is what the provider
     #   charged on the day it charged it; `amortized` spreads a commitment's up-front fee across
-    #   the term it buys. Providers that report no amortized amount fall back to their cash
+    #   the term it buys; `blended` also spreads each commitment's discount evenly over all the
+    #   usage it could cover. Providers that report no amortized amount fall back to their cash
     #   amount.
     # @param adjusted [String, nil] Apply the organization's billing rules (see /billing-rules):
     #   markups multiply, and a reallocation moves a centre's spend onto another centre. Off by
@@ -7778,7 +7857,8 @@ module Infrawrench
     # @param to [String, nil] Defaults to today.
     # @param basis [String, nil] Which money to sum. `cash` (the default) is what the provider
     #   charged on the day it charged it; `amortized` spreads a commitment's up-front fee across
-    #   the term it buys. Providers that report no amortized amount fall back to their cash
+    #   the term it buys; `blended` also spreads each commitment's discount evenly over all the
+    #   usage it could cover. Providers that report no amortized amount fall back to their cash
     #   amount.
     # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
     # @return [Hash] Parsed JSON, shaped as `UntaggedSpendReport` — see
@@ -9358,9 +9438,10 @@ module Infrawrench
     # @param window_days [Integer, nil]
     # @param cost_basis [String, nil] Which charge-type basis both windows are read on. `cash`
     #   (the default) is what the provider charged on the day it charged it; `amortized` spreads a
-    #   commitment's up-front fee across the term it buys. It is echoed on every response because
-    #   a delta whose basis is unstated is unreadable — an amortized 'after' against a cash
-    #   'before' looks exactly like a saving.
+    #   commitment's up-front fee across the term it buys; `blended` also spreads each
+    #   commitment's discount evenly over the usage it could cover. It is echoed on every response
+    #   because a delta whose basis is unstated is unreadable — an amortized 'after' against a
+    #   cash 'before' looks exactly like a saving.
     # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
     # @return [Hash] Parsed JSON, shaped as `DeploymentCostImpact` — see
     #   `sig/infrawrench/sdk.rbs`.
@@ -13223,6 +13304,124 @@ module Infrawrench
     end
   end
 
+  # `client.network_flows.kubernetes.settings`
+  class NetworkFlowsKubernetesSettingsNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # Read a cluster's network cost settings
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/network-flows/kubernetes/{accountId}/settings
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Defaults to the `org_id` the client was constructed with.
+    # @param account_id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `KubernetesNetworkSettings` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(account_id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/network-flows/kubernetes/{accountId}/settings",
+        path_params: { "orgId" => org_id, "accountId" => account_id },
+        request_options: request_options
+      )
+    end
+
+    # Set the billed data-transfer source for a cluster
+    #
+    # Say which billed cost rows are this cluster's data transfer, in the cost
+    # query language. An empty or null query clears it. A query that narrows
+    # nothing is refused: it would apportion the whole bill across one cluster.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # PUT /api/org/{orgId}/network-flows/kubernetes/{accountId}/settings
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 403: Forbidden
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Defaults to the `org_id` the client was constructed with.
+    # @param account_id [String]
+    # @param body [Hash] Request body, shaped as `Hash`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `KubernetesNetworkSettings` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def update(account_id:, body:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "PUT",
+        path: "/api/org/{orgId}/network-flows/kubernetes/{accountId}/settings",
+        path_params: { "orgId" => org_id, "accountId" => account_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+  end
+
+  # `client.network_flows.kubernetes`
+  class NetworkFlowsKubernetesNamespace
+    # @return [NetworkFlowsKubernetesSettingsNamespace] `client.network_flows.kubernetes.settings`
+    attr_reader :settings
+
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+      @settings = NetworkFlowsKubernetesSettingsNamespace.new(@transport)
+    end
+
+    # Kubernetes network costs for one cluster
+    #
+    # Pod-level network attribution for a Kubernetes account: bytes by
+    # namespace, workload and boundary (same zone, cross-zone, cross-region,
+    # internet), the largest workload → peer pairs, and which sources the
+    # figures came from.
+    #
+    # `estimatedCost` is bytes at the published rate of the cloud the nodes run
+    # on, with any per-cluster overrides from the account's rates field. When a
+    # billed source is configured (`PUT .../settings`), `allocatedCost`
+    # apportions that real billed spend across the rows day by day, never
+    # handing out more than was billed; the rest is `unallocatedCost`.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/network-flows/kubernetes/{accountId}
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Defaults to the `org_id` the client was constructed with.
+    # @param account_id [String]
+    # @param from [String, nil] Inclusive start day. Defaults to 13 days ago.
+    # @param to [String, nil] Inclusive end day. Defaults to today.
+    # @param limit [Integer, nil] Pairs to return in `topTalkers`. Defaults to 25.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `KubernetesNetworkReport` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(account_id:, org_id: nil, from: nil, to: nil, limit: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/network-flows/kubernetes/{accountId}",
+        path_params: { "orgId" => org_id, "accountId" => account_id },
+        query: { "from" => from, "to" => to, "limit" => limit },
+        request_options: request_options
+      )
+    end
+  end
+
   # `client.network_flows.settings`
   class NetworkFlowsSettingsNamespace
     # @api private
@@ -13289,6 +13488,8 @@ module Infrawrench
 
   # `client.network_flows`
   class NetworkFlowsNamespace
+    # @return [NetworkFlowsKubernetesNamespace] `client.network_flows.kubernetes`
+    attr_reader :kubernetes
     # @return [NetworkFlowsSettingsNamespace] `client.network_flows.settings`
     attr_reader :settings
 
@@ -13296,6 +13497,7 @@ module Infrawrench
     # @param transport [Transport]
     def initialize(transport)
       @transport = transport
+      @kubernetes = NetworkFlowsKubernetesNamespace.new(@transport)
       @settings = NetworkFlowsSettingsNamespace.new(@transport)
     end
 

data/lib/infrawrench/sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/lib/infrawrench/transport.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/lib/infrawrench/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -15,5 +15,5 @@
 # Kept in its own file so the gemspec can read the version without loading the
 # client — a gemspec that pulls in net/http is a gemspec that can fail to parse.
 module Infrawrench
-  VERSION = "1.66.0"
+  VERSION = "1.69.0"
 end

data/lib/infrawrench-sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/sig/infrawrench/sdk.rbs

@@ -1,7 +1,7 @@
-# infrawrench-sdk v1.66.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.69.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.66.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.69.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -1105,7 +1105,7 @@ module Infrawrench
   # The basis `actualCents` and `forecastCents` were measured on.
   #
   # Spec schema: `BudgetCostBasis`.
-  type budget_cost_basis = "cash" | "amortized"
+  type budget_cost_basis = "cash" | "amortized" | "blended"
 
   # Spec schema: `BudgetCostFilter`.
   type budget_cost_filter = {
@@ -1261,6 +1261,8 @@ module Infrawrench
     "currency" => String | nil,
     "costScope" => Array[business_metric_scope_term],
     "savedFilterId" => String | nil,
+    "labelMappings" => Array[business_metric_label_mapping],
+    "thresholds" => Array[unit_cost_threshold],
     "createdByUserId" => String | nil,
     "createdAt" => String,
     "updatedAt" => String,
@@ -1385,7 +1387,9 @@ module Infrawrench
     "kind" => business_metric_kind,
     ?"currency" => String,
     ?"costScope" => Array[business_metric_scope_term],
-    ?"savedFilterId" => String
+    ?"savedFilterId" => String,
+    ?"labelMappings" => Array[business_metric_label_mapping],
+    ?"thresholds" => Array[unit_cost_threshold]
   }
 
   # What the metric's numbers are. `count` is a unit-less quantity (customers,
@@ -1397,6 +1401,65 @@ module Infrawrench
   # Spec schema: `BusinessMetricKind`.
   type business_metric_kind = "count" | "currency"
 
+  # Joins a label to a cost dimension so unit cost and margin can be computed
+  # per label value (cost per customer). Ratio modes refuse an unmapped label:
+  # without a per-value numerator the only spend available is the whole scope's.
+  #
+  # Spec schema: `BusinessMetricLabelMapping`.
+  type business_metric_label_mapping = { "label" => String, "target" => business_metric_label_target }
+
+  # Spec schema: `BusinessMetricLabelSummary`.
+  type business_metric_label_summary = {
+    "key" => String,
+    "values" => Array[String],
+    "truncated" => bool,
+    "mapping" => business_metric_label_target
+      & ({
+          "kind" => "dimension",
+          "dimension" => "provider"
+            | "account"
+            | "service"
+            | "region"
+            | "resource"
+            | "tag"
+            | "charge_type"
+            | "commitment"
+            | "virtual_tag",
+          ?"tagKey" => String
+        }
+        | { "kind" => "cost_centre" }
+        | nil)
+  }
+
+  # Where a label's values live on the cost side. A `dimension` target matches
+  # label values to dimension values exactly; `cost_centre` matches a centre by
+  # id or, case-insensitively, by name.
+  #
+  # Spec schema: `BusinessMetricLabelTarget`.
+  type business_metric_label_target = {
+      "kind" => "dimension",
+      "dimension" => "provider"
+        | "account"
+        | "service"
+        | "region"
+        | "resource"
+        | "tag"
+        | "charge_type"
+        | "commitment"
+        | "virtual_tag",
+      ?"tagKey" => String
+    }
+    | { "kind" => "cost_centre" }
+
+  # A value's labels, e.g. `{ "customer": "acme", "plan": "pro" }`. At most 8,
+  # keys are slugs, values up to 200 characters. Rows partition the metric: a
+  # day's total is the sum of every row for it, so report a breakdown or a
+  # total, never both. The same day with the same labels restates; different
+  # labels are a different row.
+  #
+  # Spec schema: `BusinessMetricLabels`.
+  type business_metric_labels = Hash[String, String]
+
   # Spec schema: `BusinessMetricScopeTerm`.
   type business_metric_scope_term = {
     "dimension" => "provider"
@@ -1449,12 +1512,20 @@ module Infrawrench
     "day" => String,
     "value" => Numeric,
     "label" => String | nil,
+    "labels" => business_metric_labels,
     "source" => "api" | "workflow" | "import",
     "updatedAt" => String
   }
 
   # Spec schema: `BusinessMetricValuesInput`.
-  type business_metric_values_input = { "values" => Array[{ "date" => String, "value" => Numeric, ?"label" => String }] }
+  type business_metric_values_input = {
+    "values" => Array[{
+      "date" => String,
+      "value" => Numeric,
+      ?"label" => String,
+      ?"labels" => business_metric_labels
+    }]
+  }
 
   # Spec schema: `CalendarEvent`.
   type calendar_event = {
@@ -1646,12 +1717,14 @@ module Infrawrench
 
   # Which charge-type basis both windows are read on. `cash` (the default) is
   # what the provider charged on the day it charged it; `amortized` spreads a
-  # commitment's up-front fee across the term it buys. It is echoed on every
-  # response because a delta whose basis is unstated is unreadable — an
-  # amortized 'after' against a cash 'before' looks exactly like a saving.
+  # commitment's up-front fee across the term it buys; `blended` also spreads
+  # each commitment's discount evenly over the usage it could cover. It is
+  # echoed on every response because a delta whose basis is unstated is
+  # unreadable — an amortized 'after' against a cash 'before' looks exactly like
+  # a saving.
   #
   # Spec schema: `ChangeCostBasis`.
-  type change_cost_basis = "cash" | "amortized"
+  type change_cost_basis = "cash" | "amortized" | "blended"
 
   # Spec schema: `ChangeCostImpact`.
   type change_cost_impact = {
@@ -1974,6 +2047,7 @@ module Infrawrench
     "dimensions" => Array["service" | "region" | "resource" | "tag"],
     "chargeTypes" => bool,
     "amortization" => bool,
+    ?"blending" => bool,
     "estimated" => bool,
     "granularity" => "daily" | "hourly",
     "costLastPolledAt" => String | nil,
@@ -2282,10 +2356,16 @@ module Infrawrench
   # `amortized` spreads a commitment's up-front fee across the term it buys, so
   # a year of capacity bought on one day is counted on the days it covers.
   # Providers that report no amortized amount fall back to their cash amount, so
-  # an amortized query over a mixed estate never drops their spend.
+  # an amortized query over a mixed estate never drops their spend. `blended` is
+  # amortized with each commitment's discount (reservations, savings plans,
+  # committed-use discounts) spread evenly over all the usage it was eligible to
+  # cover, so every eligible hour in the commitment's scope carries the same
+  # effective rate whichever account or resource the provider applied it to: the
+  # fair basis for chargeback. Day totals equal the amortized totals exactly;
+  # rows a provider did not blend fall back to their amortized amount.
   #
   # Spec schema: `CostBasis`.
-  type cost_basis = "cash" | "amortized"
+  type cost_basis = "cash" | "amortized" | "blended"
 
   # Time bucket of the x axis. Weeks start on Monday and quarters on the first
   # of January, April, July and October (UTC). `cumulative` is the older
@@ -2345,7 +2425,7 @@ module Infrawrench
       "dateRange" => cost_date_range,
       ?"filters" => Array[cost_report_filter],
       ?"savedFilterId" => String,
-      ?"costBasis" => "cash" | "amortized",
+      ?"costBasis" => "cash" | "amortized" | "blended",
       ?"adjusted" => bool
     }
     | {
@@ -2354,7 +2434,7 @@ module Infrawrench
       "dateRange" => cost_date_range,
       ?"filters" => Array[cost_report_filter],
       ?"savedFilterId" => String,
-      ?"costBasis" => "cash" | "amortized"
+      ?"costBasis" => "cash" | "amortized" | "blended"
     }
     | {
       "type" => "forecast",
@@ -2421,7 +2501,7 @@ module Infrawrench
     ?"groupByTagKey" => String,
     ?"filters" => Array[cost_report_filter],
     ?"savedFilterId" => String,
-    ?"costBasis" => "cash" | "amortized",
+    ?"costBasis" => "cash" | "amortized" | "blended",
     ?"adjusted" => bool,
     ?"topN" => Integer
   }
@@ -2651,7 +2731,7 @@ module Infrawrench
       | "adjustment"
       | "support"
       | "other"],
-    ?"costBasis" => "cash" | "amortized"
+    ?"costBasis" => "cash" | "amortized" | "blended"
   }
 
   # Spec schema: `CostExportRunResult`.
@@ -2736,10 +2816,17 @@ module Infrawrench
     ?"comparePreviousPeriod" => bool,
     ?"showForecast" => bool,
     ?"scenarioModelId" => String,
-    ?"costBasis" => "cash" | "amortized",
+    ?"costBasis" => "cash" | "amortized" | "blended",
     ?"measure" => cost_measure,
     ?"usageUnit" => String,
-    ?"cumulative" => bool
+    ?"cumulative" => bool,
+    ?"unitCostMetricId" => String,
+    ?"unitCostMode" => "unit_cost" | "margin" | "usage_unit_cost" | "raw_metric",
+    ?"unitCostScale" => Numeric | Numeric | Numeric | Numeric | Numeric,
+    ?"unitCostUsageUnit" => String,
+    ?"unitCostLabelFilters" => Array[{ "key" => String, "op" => "in" | "not_in", "values" => Array[String] }],
+    ?"unitCostGroupByLabel" => String,
+    ?"adjusted" => bool
   }
 
   # What the Y axis sums. `cost` (the default) is money per currency. `usage`
@@ -3996,7 +4083,7 @@ module Infrawrench
   # Spec schema: `EfficiencyAlertEvent`.
   type efficiency_alert_event = {
     "id" => String,
-    "kind" => "commitment_expiry" | "commitment_idle" | "unit_cost_regression",
+    "kind" => "commitment_expiry" | "commitment_idle" | "unit_cost_regression" | "unit_cost_threshold",
     "subject" => String,
     "accountId" => String | nil,
     "accountName" => String | nil,
@@ -4950,7 +5037,7 @@ module Infrawrench
   #
   # Spec schema: `InvoiceDerivation`.
   type invoice_derivation = {
-    "costBasis" => "cash" | "amortized",
+    "costBasis" => "cash" | "amortized" | "blended",
     "applyBillingRules" => bool,
     "rateDate" => String,
     "rates" => Array[{ "currency" => String, "rate" => Numeric, "effectiveFrom" => String }],
@@ -5155,6 +5242,67 @@ module Infrawrench
   # Spec schema: `JsonObject`.
   type json_object = Hash[String, untyped]
 
+  # Spec schema: `KubernetesNetworkReport`.
+  type kubernetes_network_report = {
+    "accountId" => String,
+    "displayName" => String,
+    "range" => { "from" => String, "to" => String },
+    "estimated" => bool,
+    "currency" => String,
+    "totals" => {
+      "bytes" => Numeric,
+      "estimatedCost" => Numeric,
+      "allocatedCost" => Numeric | nil,
+      "unallocatedCost" => Numeric | nil
+    },
+    "billed" => {
+      "query" => String | nil,
+      "error" => String | nil,
+      "billedCost" => Numeric | nil,
+      "basis" => "cost" | "bytes" | "none",
+      "scaledDays" => Integer,
+      "daysWithoutBilled" => Integer
+    },
+    "scopes" => Array[{
+      "scope" => "intra_zone"
+        | "cross_zone"
+        | "cross_region"
+        | "internet_egress"
+        | "internet_ingress"
+        | "provider_service"
+        | "nat_gateway"
+        | "private_interconnect"
+        | "unknown",
+      "bytes" => Numeric,
+      "estimatedCost" => Numeric,
+      "allocatedCost" => Numeric | nil
+    }],
+    "methods" => Array[{
+      "method" => "flow_log" | "in_cluster_flows" | "counter_estimate" | "",
+      "bytes" => Numeric
+    }],
+    "namespaces" => Array[kubernetes_network_row],
+    "workloads" => Array[kubernetes_network_row],
+    "topTalkers" => Array[network_flow_pair],
+    "collection" => network_flow_account_status & (Hash[String, untyped] | nil)
+  }
+
+  # Spec schema: `KubernetesNetworkRow`.
+  type kubernetes_network_row = {
+    "key" => String,
+    "label" => String,
+    "namespace" => String,
+    "kind" => "workload" | "namespace" | "node" | "truncated",
+    "bytes" => Numeric,
+    "estimatedCost" => Numeric,
+    "allocatedCost" => Numeric | nil,
+    "byScope" => Hash[String, Numeric],
+    "method" => "flow_log" | "in_cluster_flows" | "counter_estimate" | ""
+  }
+
+  # Spec schema: `KubernetesNetworkSettings`.
+  type kubernetes_network_settings = { "accountId" => String, "billedQuery" => String | nil, "updatedAt" => String | nil }
+
   # Spec schema: `KvCommandRequest`.
   type kv_command_request = {
     "accountId" => String,
@@ -5363,7 +5511,7 @@ module Infrawrench
     "contactEmail" => String | nil,
     "billingAddress" => String | nil,
     "billingCurrency" => String,
-    "costBasis" => "cash" | "amortized",
+    "costBasis" => "cash" | "amortized" | "blended",
     "applyBillingRules" => bool,
     "pricing" => managed_account_pricing & Hash[String, untyped],
     "notes" => String | nil,
@@ -5382,7 +5530,7 @@ module Infrawrench
     ?"contactEmail" => String | nil,
     ?"billingAddress" => String | nil,
     "billingCurrency" => String,
-    ?"costBasis" => "cash" | "amortized",
+    ?"costBasis" => "cash" | "amortized" | "blended",
     ?"applyBillingRules" => bool,
     ?"pricing" => managed_account_pricing & Hash[String, untyped],
     ?"notes" => String | nil,
@@ -5623,6 +5771,7 @@ module Infrawrench
     "pluginId" => String,
     "displayName" => String,
     "supportsFlows" => bool,
+    "recut" => bool,
     "collectedThrough" => String | nil,
     "lastPolledAt" => String | nil,
     "failureCount" => Integer,
@@ -9134,13 +9283,27 @@ module Infrawrench
     "uri" => String | nil
   }
 
+  # Spec schema: `UnitCostLabelFilter`.
+  type unit_cost_label_filter = { "key" => String, "op" => "in" | "not_in", "values" => Array[String] }
+
+  # `unit_cost` is spend ÷ metric value. `margin` is `(revenue − spend) ÷
+  # revenue` as a fraction, with the absolute margin beside it, and needs a
+  # `currency` metric. `usage_unit_cost` is spend ÷ the usage quantity providers
+  # report in one `usageUnit`, and needs no metric (use `POST
+  # /business-metrics/usage-unit-costs`). `raw_metric` plots the metric itself
+  # beside spend, where zero and negative values are real points.
+  #
+  # Spec schema: `UnitCostMode`.
+  type unit_cost_mode = "unit_cost" | "margin" | "usage_unit_cost" | "raw_metric"
+
   # Spec schema: `UnitCostPoint`.
   type unit_cost_point = {
     "bucket" => String,
     "value" => Numeric | nil,
     "cost" => Numeric,
     "metricValue" => Numeric | nil,
-    ?"gap" => "no_metric_value" | "non_positive_metric_value" | "unconvertible_currency",
+    ?"absoluteMargin" => Numeric | nil,
+    ?"gap" => "no_metric_value" | "non_positive_metric_value" | "unconvertible_currency" | "no_usage",
     "reportedDays" => Integer,
     "bucketDays" => Integer
   }
@@ -9150,11 +9313,15 @@ module Infrawrench
     "from" => String,
     "to" => String,
     "binning" => "hourly" | "daily" | "weekly" | "monthly" | "quarterly" | "cumulative",
-    ?"mode" => "unit_cost" | "margin",
+    ?"mode" => unit_cost_mode,
+    ?"scale" => unit_cost_scale,
+    ?"labelFilters" => Array[unit_cost_label_filter],
+    ?"groupByLabel" => String,
+    ?"usageUnit" => String,
     ?"filters" => Array[business_metric_scope_term],
     ?"query" => String,
     ?"savedFilterId" => String,
-    ?"costBasis" => "cash" | "amortized",
+    ?"costBasis" => "cash" | "amortized" | "blended",
     ?"chargeTypes" => Array[String],
     ?"displayCurrency" => String
   }
@@ -9162,15 +9329,20 @@ module Infrawrench
   # Spec schema: `UnitCostQueryResponse`.
   type unit_cost_query_response = {
     "metric" => {
-      "id" => String,
-      "key" => String,
-      "name" => String,
-      "unit" => String,
-      "kind" => business_metric_kind,
-      "currency" => String | nil
-    },
-    "mode" => "unit_cost" | "margin",
+        "id" => String,
+        "key" => String,
+        "name" => String,
+        "unit" => String,
+        "kind" => business_metric_kind,
+        "currency" => String | nil
+      }
+      | nil,
+    "mode" => unit_cost_mode,
     "binning" => "hourly" | "daily" | "weekly" | "monthly" | "quarterly" | "cumulative",
+    "scale" => unit_cost_scale,
+    ?"usageUnit" => String,
+    ?"groupByLabel" => String,
+    ?"costPerLabel" => bool,
     "series" => Array[unit_cost_series],
     ?"conversion" => {
       "displayCurrency" => String,
@@ -9184,13 +9356,35 @@ module Infrawrench
     "partialBuckets" => Integer
   }
 
+  # "Per N units": multiplies a ratio (cost per 1,000 requests) and divides a
+  # raw metric. Margin ignores it. Absent is 1.
+  #
+  # Spec schema: `UnitCostScale`.
+  type unit_cost_scale = Numeric | Numeric | Numeric | Numeric | Numeric
+
   # Spec schema: `UnitCostSeries`.
   type unit_cost_series = {
     "currency" => String,
+    ?"label" => { "key" => String, "value" => String | nil, ?"other" => bool },
     "points" => Array[unit_cost_point],
     "overallValue" => Numeric | nil,
     "overallCost" => Numeric,
-    "overallMetricValue" => Numeric | nil
+    "overallMetricValue" => Numeric | nil,
+    ?"overallAbsoluteMargin" => Numeric | nil
+  }
+
+  # A standing limit, evaluated daily on the summed ratio over the trailing
+  # window and routed under the unit-cost alert trigger. A window with fewer
+  # than half its days reported is not judged.
+  #
+  # Spec schema: `UnitCostThreshold`.
+  type unit_cost_threshold = {
+    "mode" => "unit_cost" | "margin",
+    "direction" => "above" | "below",
+    "value" => Numeric,
+    ?"scale" => unit_cost_scale,
+    ?"groupByLabel" => String,
+    ?"windowDays" => Integer
   }
 
   # Spec schema: `UnpinRequest`.
@@ -9721,8 +9915,11 @@ module Infrawrench
     def importer_options: (body: { "accountId" => String, "fieldKey" => String, "params" => Hash[String, String] }, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "options" => Array[{ "id" => String, "label" => String, ?"description" => String }] }
     def importer_preview: (body: business_metric_import_preview_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> business_metric_import_preview
     def importer_sources: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "sources" => Array[business_metric_source_account] }
+    def labels: (id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "labels" => Array[business_metric_label_summary] }
     def unit_costs: (id: String, body: unit_cost_query_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> unit_cost_query_response
     def update: (id: String, body: business_metric_input, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> business_metric
+    def usage_unit_costs: (body: unit_cost_query_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> unit_cost_query_response
+    def usage_units: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "units" => Array[{ "unit" => String, "usage" => Numeric, "services" => Array[String] }] }
   end
 
   class CalendarSubscriptionsNamespace
@@ -9995,13 +10192,13 @@ module Infrawrench
     def anomaly_precision: (?org_id: String?, ?months: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_anomaly_precision_report
     def anomaly_sensitivity: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_anomaly_sensitivity
     def dimensions: (dimension: "provider" | "account" | "service" | "region" | "resource" | "tag" | "charge_type" | "commitment" | "virtual_tag" | "tag-keys" | "usage-units" | "virtual-tag-keys", ?org_id: String?, ?tag_key: String?, ?include_hidden: "true" | "false"?, ?request_options: Hash[Symbol, untyped]?) -> cost_dimension_values
-    def efficiency_alerts: (?org_id: String?, ?kind: "commitment_expiry" | "commitment_idle" | "unit_cost_regression"?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> { "events" => Array[efficiency_alert_event] }
+    def efficiency_alerts: (?org_id: String?, ?kind: "commitment_expiry" | "commitment_idle" | "unit_cost_regression" | "unit_cost_threshold"?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> { "events" => Array[efficiency_alert_event] }
     def focus_export: (body: focus_export_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> String
     def query: (body: cost_query_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_query_response
     def rows: (body: cost_push_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_push_response
-    def showback: (?org_id: String?, ?from: String?, ?to: String?, ?basis: "cash" | "amortized"?, ?adjusted: "true" | "false"?, ?request_options: Hash[Symbol, untyped]?) -> showback_report
+    def showback: (?org_id: String?, ?from: String?, ?to: String?, ?basis: "cash" | "amortized" | "blended"?, ?adjusted: "true" | "false"?, ?request_options: Hash[Symbol, untyped]?) -> showback_report
     def status: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "accounts" => Array[cost_account_status] }
-    def untagged: (?org_id: String?, ?from: String?, ?to: String?, ?basis: "cash" | "amortized"?, ?request_options: Hash[Symbol, untyped]?) -> untagged_spend_report
+    def untagged: (?org_id: String?, ?from: String?, ?to: String?, ?basis: "cash" | "amortized" | "blended"?, ?request_options: Hash[Symbol, untyped]?) -> untagged_spend_report
   end
 
   class CredentialHygieneNamespace
@@ -10395,6 +10592,18 @@ module Infrawrench
     def test: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "ok" => bool, "webhookCount" => Integer, "attempted" => Integer, "succeeded" => Integer }
   end
 
+  class NetworkFlowsKubernetesSettingsNamespace
+    def initialize: (Transport) -> void
+    def get: (account_id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> kubernetes_network_settings
+    def update: (account_id: String, body: { "billedQuery" => String | nil }, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> kubernetes_network_settings
+  end
+
+  class NetworkFlowsKubernetesNamespace
+    attr_reader settings: NetworkFlowsKubernetesSettingsNamespace
+    def initialize: (Transport) -> void
+    def get: (account_id: String, ?org_id: String?, ?from: String?, ?to: String?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> kubernetes_network_report
+  end
+
   class NetworkFlowsSettingsNamespace
     def initialize: (Transport) -> void
     def get: (?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> network_flow_settings
@@ -10402,6 +10611,7 @@ module Infrawrench
   end
 
   class NetworkFlowsNamespace
+    attr_reader kubernetes: NetworkFlowsKubernetesNamespace
     attr_reader settings: NetworkFlowsSettingsNamespace
     def initialize: (Transport) -> void
     def get: (?org_id: String?, ?from: String?, ?to: String?, ?scope: "intra_zone" | "cross_zone" | "cross_region" | "internet_egress" | "internet_ingress" | "provider_service" | "nat_gateway" | "private_interconnect" | "unknown"?, ?account_id: String?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> network_flow_feed

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infrawrench-sdk
 version: !ruby/object:Gem::Version
-  version: 1.66.0
+  version: 1.69.0
 platform: ruby
 authors:
 - Infrawrench LLC
@@ -11,7 +11,7 @@ bindir: bin
 cert_chain: []
 date: 2026-10-05 00:00:00.000000000 Z
 dependencies: []
-description: Generated Ruby client for the Infrawrench API (v1.66.0). Covers the published
+description: Generated Ruby client for the Infrawrench API (v1.69.0). Covers the published
   API surface only — operations marked x-internal in the spec are not generated. No
   runtime dependencies.
 email:
@@ -58,5 +58,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Generated Ruby client for the Infrawrench API (v1.66.0).
+summary: Generated Ruby client for the Infrawrench API (v1.69.0).
 test_files: []