anthropic 2.1.0 → 2.2.0

data/rbi/anthropic/models/beta/organization/analytics/beta_analytics_usage_item.rbi

@@ -0,0 +1,110 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          class BetaAnalyticsUsageItem < Anthropic::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageItem,
+                  Anthropic::Internal::AnyHash
+                )
+              end
+
+            # End of the period this row covers (exclusive), as an RFC 3339 UTC timestamp: the
+            # end of the row's time bucket when a time-bucket width is set; otherwise the
+            # requested `ending_at` (or, when omitted, the earlier of now and `starting_at`
+            # plus 31 days) rounded down to the hour, because without a time bucket the report
+            # covers whole hours.
+            sig { returns(Time) }
+            attr_accessor :ending_at
+
+            # The dimension values this row's usage is broken out by.
+            sig do
+              returns(
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageGroup
+              )
+            end
+            attr_reader :group
+
+            sig do
+              params(
+                group:
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageGroup::OrHash
+              ).void
+            end
+            attr_writer :group
+
+            # Start of the period this row covers (inclusive), as an RFC 3339 UTC timestamp:
+            # the start of the row's time bucket when a time-bucket width is set, otherwise
+            # the requested `starting_at` rounded down to the hour.
+            sig { returns(Time) }
+            attr_accessor :starting_at
+
+            # Token usage for this row.
+            sig do
+              returns(
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageMetrics
+              )
+            end
+            attr_reader :usage
+
+            sig do
+              params(
+                usage:
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageMetrics::OrHash
+              ).void
+            end
+            attr_writer :usage
+
+            sig do
+              params(
+                ending_at: Time,
+                group:
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageGroup::OrHash,
+                starting_at: Time,
+                usage:
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageMetrics::OrHash
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # End of the period this row covers (exclusive), as an RFC 3339 UTC timestamp: the
+              # end of the row's time bucket when a time-bucket width is set; otherwise the
+              # requested `ending_at` (or, when omitted, the earlier of now and `starting_at`
+              # plus 31 days) rounded down to the hour, because without a time bucket the report
+              # covers whole hours.
+              ending_at:,
+              # The dimension values this row's usage is broken out by.
+              group:,
+              # Start of the period this row covers (inclusive), as an RFC 3339 UTC timestamp:
+              # the start of the row's time bucket when a time-bucket width is set, otherwise
+              # the requested `starting_at` rounded down to the hour.
+              starting_at:,
+              # Token usage for this row.
+              usage:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  ending_at: Time,
+                  group:
+                    Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageGroup,
+                  starting_at: Time,
+                  usage:
+                    Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageMetrics
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/organization/analytics/beta_analytics_usage_metrics.rbi

@@ -0,0 +1,120 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          class BetaAnalyticsUsageMetrics < Anthropic::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageMetrics,
+                  Anthropic::Internal::AnyHash
+                )
+              end
+
+            # The number of input tokens for cache creation.
+            sig { returns(Anthropic::Beta::BetaCacheCreation) }
+            attr_reader :cache_creation
+
+            sig do
+              params(
+                cache_creation: Anthropic::Beta::BetaCacheCreation::OrHash
+              ).void
+            end
+            attr_writer :cache_creation
+
+            # The number of input tokens read from the cache.
+            sig { returns(Integer) }
+            attr_accessor :cache_read_input_tokens
+
+            # The number of output tokens generated.
+            sig { returns(Integer) }
+            attr_accessor :output_tokens
+
+            # Number of API requests in this row's scope. For sandbox / code-execution events,
+            # this counts execution spans rather than HTTP requests (these rows surface with
+            # `product: null`).
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :requests
+
+            # Server-side tool usage metrics.
+            sig do
+              returns(Anthropic::Beta::Organization::BetaAnalyticsServerToolUse)
+            end
+            attr_reader :server_tool_use
+
+            sig do
+              params(
+                server_tool_use:
+                  Anthropic::Beta::Organization::BetaAnalyticsServerToolUse::OrHash
+              ).void
+            end
+            attr_writer :server_tool_use
+
+            # Total token count across all token types. This is the value the default
+            # `order_by` (`total_tokens`) sorts on.
+            sig { returns(Integer) }
+            attr_accessor :total_tokens
+
+            # The number of uncached input tokens processed.
+            sig { returns(Integer) }
+            attr_accessor :uncached_input_tokens
+
+            # The token usage of one row.
+            sig do
+              params(
+                cache_creation: Anthropic::Beta::BetaCacheCreation::OrHash,
+                cache_read_input_tokens: Integer,
+                output_tokens: Integer,
+                requests: T.nilable(Integer),
+                server_tool_use:
+                  Anthropic::Beta::Organization::BetaAnalyticsServerToolUse::OrHash,
+                total_tokens: Integer,
+                uncached_input_tokens: Integer
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The number of input tokens for cache creation.
+              cache_creation:,
+              # The number of input tokens read from the cache.
+              cache_read_input_tokens:,
+              # The number of output tokens generated.
+              output_tokens:,
+              # Number of API requests in this row's scope. For sandbox / code-execution events,
+              # this counts execution spans rather than HTTP requests (these rows surface with
+              # `product: null`).
+              requests:,
+              # Server-side tool usage metrics.
+              server_tool_use:,
+              # Total token count across all token types. This is the value the default
+              # `order_by` (`total_tokens`) sorts on.
+              total_tokens:,
+              # The number of uncached input tokens processed.
+              uncached_input_tokens:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  cache_creation: Anthropic::Beta::BetaCacheCreation,
+                  cache_read_input_tokens: Integer,
+                  output_tokens: Integer,
+                  requests: T.nilable(Integer),
+                  server_tool_use:
+                    Anthropic::Beta::Organization::BetaAnalyticsServerToolUse,
+                  total_tokens: Integer,
+                  uncached_input_tokens: Integer
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/organization/analytics/beta_analytics_usage_order_by.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module Analytics
+          module BetaAnalyticsUsageOrderBy
+            extend Anthropic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            OUTPUT_TOKENS =
+              T.let(
+                :output_tokens,
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy::TaggedSymbol
+              )
+            REQUESTS =
+              T.let(
+                :requests,
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy::TaggedSymbol
+              )
+            TIME =
+              T.let(
+                :time,
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy::TaggedSymbol
+              )
+            TOTAL_TOKENS =
+              T.let(
+                :total_tokens,
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy::TaggedSymbol
+              )
+            UNCACHED_INPUT_TOKENS =
+              T.let(
+                :uncached_input_tokens,
+                Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Anthropic::Beta::Organization::Analytics::BetaAnalyticsUsageOrderBy::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end