anthropic 1.74.0 → 1.76.0

data/rbi/anthropic/models/beta/organization/beta_analytics_usage_bucketed_result.rbi

@@ -0,0 +1,372 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsUsageBucketedResult < Anthropic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult,
+                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
+
+          # Claude Tag (Claude in Slack) spend category: `engaged` (a person addressed
+          # Claude in a channel or thread), `proactive` (Claude responded without being
+          # addressed), `scheduled` (a scheduled routine ran), `monitoring` (Claude watching
+          # a channel it was asked to monitor), or `dm` (direct messages with Claude).
+          # Populated only when `claude_tag_category` is in `group_by[]`; null for usage
+          # that is not Claude Tag. Direct-message usage is billed to the individual user
+          # and is reported under that user's product, not under `claude-tag`. New
+          # categories may be added over time.
+          sig do
+            returns(
+              T.nilable(
+                Anthropic::Beta::Organization::BetaAnalyticsClaudeTagCategory::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :claude_tag_category
+
+          # Slack user ID (for example `U0123ABCDEF`) of the member the Claude Tag (Claude
+          # in Slack) usage is attributed to, not a claude.ai user ID. Populated only when
+          # `claude_tag_user_id` is in `group_by[]`; null for usage that is not Claude Tag
+          # and for Claude Tag usage that is not attributed to a single user (for example
+          # `monitoring`, and `proactive` usage Claude initiated), so per-user rows can sum
+          # to less than the Claude Tag total. Cannot be combined with
+          # `group_by[]=rbac_group_id` or the `rbac_group_ids[]` filter.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :claude_tag_user_id
+
+          # Context-window pricing tier of the usage or cost. Null unless `context_window`
+          # is in `group_by[]`; it can also be null on grouped rows with no context-window
+          # tier, such as code execution.
+          sig do
+            returns(
+              T.nilable(
+                Anthropic::Beta::Organization::BetaAnalyticsContextWindow::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :context_window
+
+          # Inference region of the usage or cost. Null unless `inference_geo` is in
+          # `group_by[]`; it can also be null on grouped rows where the region is not set
+          # (the rows that `inference_geos[]=not_available` matches).
+          sig do
+            returns(
+              T.nilable(
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :inference_geo
+
+          # Model that produced the usage or cost, as a model name in the form the
+          # `models[]` filter accepts (for example, `claude-opus-5`). Null unless `model` is
+          # in `group_by[]`; it can also be null on grouped rows whose usage or cost is not
+          # attributed to a specific model, such as code execution.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :model
+
+          # The number of output tokens generated.
+          sig { returns(Integer) }
+          attr_accessor :output_tokens
+
+          # Product surface that produced the usage or cost. Null unless product is in
+          # `group_by[]`; it can also be null on grouped rows whose usage cannot be
+          # attributed to a known surface. Values include `chat`, `claude_code`, `cowork`,
+          # `office_agent`, `claude_in_chrome`, `claude_design`, and `claude-tag`.
+          # `claude-tag` is Claude Tag, the Claude product in Slack. Some unattributed usage
+          # is reported as "other".
+          sig { returns(T.nilable(String)) }
+          attr_accessor :product
+
+          # RBAC group (team) the usage is attributed to, in the public tagged
+          # `rbac_group_...` spelling — the same spelling the activity resources use for
+          # this key, so the same team has one id across resources and it round-trips as an
+          # `rbac_group_ids[]` filter value. Populated only when `rbac_group_id` is in
+          # `group_by[]`. Any-membership semantics: a user in several groups contributes
+          # their full usage to each of those groups' rows, so the named-group rows overlap
+          # and their sum can exceed the org total. A null value is the single unassigned
+          # row: users in no group on that (UTC) day. For the true org total, run the same
+          # query without `group_by[]`.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :rbac_group_id
+
+          # 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
+
+          # Slack channel the usage originated from. Populated only when `slack_channel_id`
+          # is in `group_by[]`; null for usage outside Slack (and for rows recorded before
+          # channel attribution was enabled).
+          sig { returns(T.nilable(String)) }
+          attr_accessor :slack_channel_id
+
+          # Inference speed mode of the usage or cost: `fast` or `standard`. Null unless
+          # `speed` is in `group_by[]`.
+          sig do
+            returns(
+              T.nilable(
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :speed
+
+          # The number of uncached input tokens processed.
+          sig { returns(Integer) }
+          attr_accessor :uncached_input_tokens
+
+          sig do
+            params(
+              cache_creation: Anthropic::Beta::BetaCacheCreation::OrHash,
+              cache_read_input_tokens: Integer,
+              claude_tag_category:
+                T.nilable(
+                  Anthropic::Beta::Organization::BetaAnalyticsClaudeTagCategory::OrSymbol
+                ),
+              claude_tag_user_id: T.nilable(String),
+              context_window:
+                T.nilable(
+                  Anthropic::Beta::Organization::BetaAnalyticsContextWindow::OrSymbol
+                ),
+              inference_geo:
+                T.nilable(
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo::OrSymbol
+                ),
+              model: T.nilable(String),
+              output_tokens: Integer,
+              product: T.nilable(String),
+              rbac_group_id: T.nilable(String),
+              requests: T.nilable(Integer),
+              server_tool_use:
+                Anthropic::Beta::Organization::BetaAnalyticsServerToolUse::OrHash,
+              slack_channel_id: T.nilable(String),
+              speed:
+                T.nilable(
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed::OrSymbol
+                ),
+              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:,
+            # Claude Tag (Claude in Slack) spend category: `engaged` (a person addressed
+            # Claude in a channel or thread), `proactive` (Claude responded without being
+            # addressed), `scheduled` (a scheduled routine ran), `monitoring` (Claude watching
+            # a channel it was asked to monitor), or `dm` (direct messages with Claude).
+            # Populated only when `claude_tag_category` is in `group_by[]`; null for usage
+            # that is not Claude Tag. Direct-message usage is billed to the individual user
+            # and is reported under that user's product, not under `claude-tag`. New
+            # categories may be added over time.
+            claude_tag_category:,
+            # Slack user ID (for example `U0123ABCDEF`) of the member the Claude Tag (Claude
+            # in Slack) usage is attributed to, not a claude.ai user ID. Populated only when
+            # `claude_tag_user_id` is in `group_by[]`; null for usage that is not Claude Tag
+            # and for Claude Tag usage that is not attributed to a single user (for example
+            # `monitoring`, and `proactive` usage Claude initiated), so per-user rows can sum
+            # to less than the Claude Tag total. Cannot be combined with
+            # `group_by[]=rbac_group_id` or the `rbac_group_ids[]` filter.
+            claude_tag_user_id:,
+            # Context-window pricing tier of the usage or cost. Null unless `context_window`
+            # is in `group_by[]`; it can also be null on grouped rows with no context-window
+            # tier, such as code execution.
+            context_window:,
+            # Inference region of the usage or cost. Null unless `inference_geo` is in
+            # `group_by[]`; it can also be null on grouped rows where the region is not set
+            # (the rows that `inference_geos[]=not_available` matches).
+            inference_geo:,
+            # Model that produced the usage or cost, as a model name in the form the
+            # `models[]` filter accepts (for example, `claude-opus-5`). Null unless `model` is
+            # in `group_by[]`; it can also be null on grouped rows whose usage or cost is not
+            # attributed to a specific model, such as code execution.
+            model:,
+            # The number of output tokens generated.
+            output_tokens:,
+            # Product surface that produced the usage or cost. Null unless product is in
+            # `group_by[]`; it can also be null on grouped rows whose usage cannot be
+            # attributed to a known surface. Values include `chat`, `claude_code`, `cowork`,
+            # `office_agent`, `claude_in_chrome`, `claude_design`, and `claude-tag`.
+            # `claude-tag` is Claude Tag, the Claude product in Slack. Some unattributed usage
+            # is reported as "other".
+            product:,
+            # RBAC group (team) the usage is attributed to, in the public tagged
+            # `rbac_group_...` spelling — the same spelling the activity resources use for
+            # this key, so the same team has one id across resources and it round-trips as an
+            # `rbac_group_ids[]` filter value. Populated only when `rbac_group_id` is in
+            # `group_by[]`. Any-membership semantics: a user in several groups contributes
+            # their full usage to each of those groups' rows, so the named-group rows overlap
+            # and their sum can exceed the org total. A null value is the single unassigned
+            # row: users in no group on that (UTC) day. For the true org total, run the same
+            # query without `group_by[]`.
+            rbac_group_id:,
+            # 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:,
+            # Slack channel the usage originated from. Populated only when `slack_channel_id`
+            # is in `group_by[]`; null for usage outside Slack (and for rows recorded before
+            # channel attribution was enabled).
+            slack_channel_id:,
+            # Inference speed mode of the usage or cost: `fast` or `standard`. Null unless
+            # `speed` is in `group_by[]`.
+            speed:,
+            # 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,
+                claude_tag_category:
+                  T.nilable(
+                    Anthropic::Beta::Organization::BetaAnalyticsClaudeTagCategory::TaggedSymbol
+                  ),
+                claude_tag_user_id: T.nilable(String),
+                context_window:
+                  T.nilable(
+                    Anthropic::Beta::Organization::BetaAnalyticsContextWindow::TaggedSymbol
+                  ),
+                inference_geo:
+                  T.nilable(
+                    Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo::TaggedSymbol
+                  ),
+                model: T.nilable(String),
+                output_tokens: Integer,
+                product: T.nilable(String),
+                rbac_group_id: T.nilable(String),
+                requests: T.nilable(Integer),
+                server_tool_use:
+                  Anthropic::Beta::Organization::BetaAnalyticsServerToolUse,
+                slack_channel_id: T.nilable(String),
+                speed:
+                  T.nilable(
+                    Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed::TaggedSymbol
+                  ),
+                uncached_input_tokens: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Inference region of the usage or cost. Null unless `inference_geo` is in
+          # `group_by[]`; it can also be null on grouped rows where the region is not set
+          # (the rows that `inference_geos[]=not_available` matches).
+          module InferenceGeo
+            extend Anthropic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            GLOBAL =
+              T.let(
+                :global,
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo::TaggedSymbol
+              )
+            US =
+              T.let(
+                :us,
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::InferenceGeo::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Inference speed mode of the usage or cost: `fast` or `standard`. Null unless
+          # `speed` is in `group_by[]`.
+          module Speed
+            extend Anthropic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            FAST =
+              T.let(
+                :fast,
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed::TaggedSymbol
+              )
+            STANDARD =
+              T.let(
+                :standard,
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::Speed::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/organization/beta_analytics_usage_report_time_bucket.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsUsageReportTimeBucket < Anthropic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Anthropic::Beta::Organization::BetaAnalyticsUsageReportTimeBucket,
+                Anthropic::Internal::AnyHash
+              )
+            end
+
+          # End of the time bucket (exclusive) in RFC 3339 format.
+          sig { returns(Time) }
+          attr_accessor :ending_at
+
+          # Rows for this time bucket. Empty when the bucket has no data; otherwise a single
+          # combined row when `group_by[]` is omitted, or one row per group (subject to the
+          # per-bucket group cap described on the `group_by[]` parameter).
+          sig do
+            returns(
+              T::Array[
+                Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult
+              ]
+            )
+          end
+          attr_accessor :results
+
+          # Start of the time bucket (inclusive) in RFC 3339 format.
+          sig { returns(Time) }
+          attr_accessor :starting_at
+
+          sig do
+            params(
+              ending_at: Time,
+              results:
+                T::Array[
+                  Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult::OrHash
+                ],
+              starting_at: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # End of the time bucket (exclusive) in RFC 3339 format.
+            ending_at:,
+            # Rows for this time bucket. Empty when the bucket has no data; otherwise a single
+            # combined row when `group_by[]` is omitted, or one row per group (subject to the
+            # per-bucket group cap described on the `group_by[]` parameter).
+            results:,
+            # Start of the time bucket (inclusive) in RFC 3339 format.
+            starting_at:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                ending_at: Time,
+                results:
+                  T::Array[
+                    Anthropic::Beta::Organization::BetaAnalyticsUsageBucketedResult
+                  ],
+                starting_at: Time
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end