infrawrench-sdk 1.41.0 → 1.42.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9043824b7a2681a2eb2b39260bbe15867b59a358f08be249532cd8c6df38ba21
-  data.tar.gz: 7847f5a3cd3d593159d32cb7245c40ae1a7c14f7976ce228365db5c46d9f6b63
+  metadata.gz: 3ab3b8356046b9af410fc1085404ec8da788100a7f0c5af914f877797ba19d1c
+  data.tar.gz: 6c6c416bea1d0db25aff8652d91bd8d781b75465e13a2b48929a6176222e30d1
 SHA512:
-  metadata.gz: da655770052b6c2432b29e5488a4462815cfcc7d2b5ae55ce1aa16ac0979769e3f31a3df71a1ab6b48a3a93a69775c3d704057d926073cb1027e6762b69ca4ee
-  data.tar.gz: cb800b1e28c49338de8f16907a2a352eefb9db127ee1c14bd4aaff7d80b415cd1a8b65aa7eccce4d410f24faf8ce9c749eb1305c92f571e1c2e51e694842d076
+  metadata.gz: 734aeddb14b3659bdab0fd9d366ac80113281356f1cb09bf77a0188a6e85c1e0e23797e6d0b1fee2b852e9c1bde044d6dba5168c1025e824d9aaf065497bf90b
+  data.tar.gz: dbbef6ae9157a8a96bc205ad3c338a137a61e063e3e1356346e0be79ac3e3aa9d0611897538a7ed7535e6e9b5838f0430ce435f103229150ba9247e2d0234f60

data/README.md

@@ -1,6 +1,6 @@
 # infrawrench-sdk
 
-Generated Ruby client for the Infrawrench API (API version `1.41.0`).
+Generated Ruby client for the Infrawrench API (API version `1.42.2`).
 
 **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
-739 schemas, as RBS type aliases that steep and TypeProf can read.
+746 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.41.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.42.2 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.41.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.42.2).
 #
 # 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.41.0)."
-  spec.description = "Generated Ruby client for the Infrawrench API (v1.41.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.42.2)."
+  spec.description = "Generated Ruby client for the Infrawrench API (v1.42.2). 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.41.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.42.2 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.41.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.42.2).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -3101,6 +3101,68 @@ module Infrawrench
     end
   end
 
+  # `client.carbon`
+  class CarbonNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # Estimated operational carbon, with its assumptions
+    #
+    # An **estimate**, in the same sense the cost estimates here are, and built
+    # to be honest about that in three ways.
+    #
+    # **A resource that cannot be placed is never guessed.** No published figure
+    # for the provider, no entry for the region, no vCPU count: each produces an
+    # `unestimated` row with a stated reason and contributes nothing to the
+    # total. A carbon figure computed against a guessed grid is worse than no
+    # figure, because it is a number somebody will put in a report.
+    #
+    # **The assumptions travel with the answer**: utilisation, PUE, the
+    # coefficient source and its vintage are all on the response.
+    #
+    # **It covers processors and says so.** Virtual machines, Kubernetes nodes
+    # and sized managed services; storage, memory, network egress and embodied
+    # (manufacturing) emissions are excluded. Types with nothing to read (a
+    # bucket, a DNS record) are out of scope, not unestimated.
+    #
+    # What to read comes from each plugin's `carbon` declaration (or its
+    # `rightsizing` one): the region field, and vCPUs either directly or through
+    # the create form's size catalogue. Managed clusters whose nodes are listed
+    # in their own right are left out of the total, and a Kubernetes node that
+    # is also an instance is counted once (`duplicateCount`).
+    #
+    # Grid figures are Cloud Carbon Footprint's (Apache-2.0) for AWS, GCP and
+    # Azure, and Ember's 2024 country figures for every other provider; each row
+    # says which (`gridBasis`). They are not measured by us. One resource's
+    # monthly figure rides `POST /resources/cost-estimate` as `carbon`, beside
+    # its price.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/carbon
+    #
+    # Raises on 400: Bad request
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param window_days [Integer, nil] Defaults to 30.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `CarbonEstimate` — see `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(org_id: nil, window_days: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/carbon",
+        path_params: { "orgId" => org_id },
+        query: { "windowDays" => window_days },
+        request_options: request_options
+      )
+    end
+  end
+
   # `client.change_freezes`
   class ChangeFreezesNamespace
     # @api private
@@ -14825,9 +14887,12 @@ module Infrawrench
 
     # Get the Add to Slack URL
     #
-    # Returns a slack.com/oauth/v2/authorize URL carrying a signed `state` that
-    # binds the resulting install to this organization. Send the user's browser
-    # there; Slack redirects back to /api/slack/oauth/callback.
+    # Returns a URL on this server (/api/slack/oauth/start) carrying a signed
+    # `state` that binds the resulting install to this organization and to the
+    # calling user. Open it in that user's browser within 30 minutes: it asks
+    # them to sign in if needed, then redirects to Slack's approval screen, and
+    # Slack redirects back to /api/slack/oauth/callback. The install only
+    # completes in the browser that opened the link as that user.
     #
     # GET /api/org/{orgId}/slack/install-url
     #
@@ -16749,6 +16814,8 @@ module Infrawrench
     attr_reader :business_metrics
     # @return [CalendarNamespace] `client.calendar`
     attr_reader :calendar
+    # @return [CarbonNamespace] `client.carbon`
+    attr_reader :carbon
     # @return [ChangeFreezesNamespace] `client.change_freezes`
     attr_reader :change_freezes
     # @return [ChangesNamespace] `client.changes`
@@ -16928,6 +16995,7 @@ module Infrawrench
       @budgets = BudgetsNamespace.new(@transport)
       @business_metrics = BusinessMetricsNamespace.new(@transport)
       @calendar = CalendarNamespace.new(@transport)
+      @carbon = CarbonNamespace.new(@transport)
       @change_freezes = ChangeFreezesNamespace.new(@transport)
       @changes = ChangesNamespace.new(@transport)
       @chat = ChatNamespace.new(@transport)

data/lib/infrawrench/sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.41.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.42.2 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.41.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.42.2).
 #
 # 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.41.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.42.2 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.41.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.42.2).
 #
 # 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.41.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.42.2 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.41.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.42.2).
 #
 # 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.41.0"
+  VERSION = "1.42.2"
 end

data/lib/infrawrench-sdk.rb

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

data/sig/infrawrench/sdk.rbs

@@ -1,7 +1,7 @@
-# infrawrench-sdk v1.41.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.42.2 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.41.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.42.2).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -1184,6 +1184,91 @@ module Infrawrench
     "slots" => Array[capacity_slot]
   }
 
+  # Spec schema: `CarbonAssumptions`.
+  type carbon_assumptions = {
+    "cpuUtilization" => Numeric,
+    "pue" => Hash[String, Numeric],
+    "vcpuWatts" => Hash[String, { "min" => Numeric, "max" => Numeric }],
+    "coefficientSource" => String,
+    "coefficientVintage" => String,
+    "scope" => String
+  }
+
+  # Spec schema: `CarbonEstimate`.
+  type carbon_estimate = {
+    "windowDays" => Integer,
+    "totalKgCo2e" => Numeric,
+    "totalKwh" => Numeric,
+    "estimatedCount" => Integer,
+    "unestimated" => Array[carbon_unestimated_row],
+    "unestimatedCount" => Integer,
+    "duplicateCount" => Integer,
+    "byRegion" => Array[carbon_group],
+    "byAccount" => Array[carbon_group],
+    "byProvider" => Array[carbon_group],
+    "rows" => Array[carbon_row],
+    "assumptions" => carbon_assumptions,
+    "generatedAt" => String
+  }
+
+  # Monthly (730 h) footprint, or null.
+  #
+  # Spec schema: `CarbonFootprint`.
+  type carbon_footprint = {
+      "vcpus" => Numeric,
+      "count" => Integer,
+      "region" => String,
+      "grid" => String,
+      "gridIntensity" => Numeric,
+      "gridZone" => String,
+      "gridBasis" => "ccf" | "ember-2024",
+      "pue" => Numeric,
+      "kwh" => Numeric,
+      "kgCo2e" => Numeric
+    }
+    | nil
+
+  # Spec schema: `CarbonGroup`.
+  type carbon_group = {
+    "key" => String,
+    "label" => String,
+    "kgCo2e" => Numeric,
+    "kwh" => Numeric,
+    "resourceCount" => Integer
+  }
+
+  # Spec schema: `CarbonRow`.
+  type carbon_row = {
+    "vcpus" => Numeric,
+    "count" => Integer,
+    "region" => String,
+    "grid" => String,
+    "gridIntensity" => Numeric,
+    "gridZone" => String,
+    "gridBasis" => "ccf" | "ember-2024",
+    "pue" => Numeric,
+    "kwh" => Numeric,
+    "kgCo2e" => Numeric,
+    "resourceId" => String,
+    "displayName" => String,
+    "pluginId" => String,
+    "resourceTypeId" => String,
+    "accountId" => String,
+    "accountName" => String | nil
+  }
+
+  # Spec schema: `CarbonUnestimatedRow`.
+  type carbon_unestimated_row = {
+    "resourceId" => String,
+    "displayName" => String,
+    "pluginId" => String,
+    "resourceTypeId" => String,
+    "accountId" => String,
+    "accountName" => String | nil,
+    "region" => String | nil,
+    "reason" => "unsupported-provider" | "unknown-region" | "unknown-size"
+  }
+
   # 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
@@ -2955,11 +3040,14 @@ module Infrawrench
     "currency" => String | nil,
     "partial" => bool,
     "unpricedCount" => Integer,
+    "monthlyKgCo2e" => Numeric | nil,
+    "uncarbonedCount" => Integer,
     "members" => Array[{
       "memberKey" => String,
       "displayName" => String,
       "monthlyAmount" => Numeric | nil,
-      "currency" => String | nil
+      "currency" => String | nil,
+      "monthlyKgCo2e" => Numeric | nil
     }]
   }
 
@@ -4833,6 +4921,8 @@ module Infrawrench
     "projectedCpuP95" => Numeric,
     "currency" => String,
     "monthlySaving" => Numeric | nil,
+    "currentMonthlyKgCo2e" => Numeric | nil,
+    "monthlyKgCo2eSaving" => Numeric | nil,
     "resizeNote" => String | nil,
     "lastSyncedAt" => String | nil
   }
@@ -5558,6 +5648,24 @@ module Infrawrench
     "parentResourceId" => resource_id & (String | nil)
   }
 
+  # Estimated monthly CO2e of the same configuration, beside its price. Null for
+  # a peer resource or when the size catalogue could not be read.
+  #
+  # Spec schema: `ResourceCarbonEstimate`.
+  type resource_carbon_estimate = {
+      "estimate" => carbon_footprint,
+      "reason" => "unsupported-provider" | "unknown-region" | "unknown-size" | nil,
+      "inScope" => bool,
+      "role" => "instance" | "aggregate",
+      "assumptions" => {
+        "cpuUtilization" => Numeric,
+        "coefficientSource" => String,
+        "coefficientVintage" => String,
+        "scope" => String
+      }
+    }
+    | nil
+
   # Spec schema: `ResourceChangeEntry`.
   type resource_change_entry = {
     "id" => String,
@@ -7792,6 +7900,11 @@ module Infrawrench
     def get: (?org_id: String?, ?from: String?, ?to: String?, ?kinds: String?, ?request_options: Hash[Symbol, untyped]?) -> calendar_response
   end
 
+  class CarbonNamespace
+    def initialize: (Transport) -> void
+    def get: (?org_id: String?, ?window_days: Integer?, ?request_options: Hash[Symbol, untyped]?) -> carbon_estimate
+  end
+
   class ChangeFreezesNamespace
     def initialize: (Transport) -> void
     def create: (body: change_freeze_input, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> change_freeze
@@ -8508,7 +8621,7 @@ module Infrawrench
     attr_reader ssh_install: ResourcesSshInstallNamespace
     def initialize: (Transport) -> void
     def attach: (body: attach_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> ok
-    def cost_estimate: (body: cost_estimate_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "estimate" => cost_estimate }
+    def cost_estimate: (body: cost_estimate_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "estimate" => cost_estimate, "carbon" => resource_carbon_estimate }
     def create: (body: create_resource_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> create_resource_response
     def create_config: (body: create_config_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> json_object
     def create_pricing: (body: create_pricing_request, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> Hash[String, json_object]
@@ -8828,6 +8941,7 @@ module Infrawrench
     attr_reader budgets: BudgetsNamespace
     attr_reader business_metrics: BusinessMetricsNamespace
     attr_reader calendar: CalendarNamespace
+    attr_reader carbon: CarbonNamespace
     attr_reader change_freezes: ChangeFreezesNamespace
     attr_reader changes: ChangesNamespace
     attr_reader chat: ChatNamespace

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infrawrench-sdk
 version: !ruby/object:Gem::Version
-  version: 1.41.0
+  version: 1.42.2
 platform: ruby
 authors:
 - Infrawrench LLC
@@ -11,7 +11,7 @@ bindir: bin
 cert_chain: []
 date: 2026-10-03 00:00:00.000000000 Z
 dependencies: []
-description: Generated Ruby client for the Infrawrench API (v1.41.0). Covers the published
+description: Generated Ruby client for the Infrawrench API (v1.42.2). 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.41.0).
+summary: Generated Ruby client for the Infrawrench API (v1.42.2).
 test_files: []