anthropic 2.2.0 → 2.4.0

data/rbi/anthropic/models/organization/analytics_lines_of_code.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsLinesOfCode < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsLinesOfCode,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Lines of code added
+        sig { returns(Integer) }
+        attr_accessor :added_count
+
+        # Lines of code removed
+        sig { returns(Integer) }
+        attr_accessor :removed_count
+
+        # Lines of code added and removed via Claude Code.
+        sig do
+          params(added_count: Integer, removed_count: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Lines of code added
+          added_count:,
+          # Lines of code removed
+          removed_count:
+        )
+        end
+
+        sig do
+          override.returns({ added_count: Integer, removed_count: Integer })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_office_metrics.rbi

@@ -0,0 +1,111 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsOfficeMetrics < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsOfficeMetrics,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Office Agent activity metrics for a single user on a given day within one Office
+        # product.
+        sig { returns(Anthropic::Organization::AnalyticsOfficeProductMetrics) }
+        attr_reader :excel
+
+        sig do
+          params(
+            excel:
+              Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash
+          ).void
+        end
+        attr_writer :excel
+
+        # Office Agent activity metrics for a single user on a given day within one Office
+        # product.
+        sig { returns(Anthropic::Organization::AnalyticsOfficeProductMetrics) }
+        attr_reader :outlook
+
+        sig do
+          params(
+            outlook:
+              Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash
+          ).void
+        end
+        attr_writer :outlook
+
+        # Office Agent activity metrics for a single user on a given day within one Office
+        # product.
+        sig { returns(Anthropic::Organization::AnalyticsOfficeProductMetrics) }
+        attr_reader :powerpoint
+
+        sig do
+          params(
+            powerpoint:
+              Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash
+          ).void
+        end
+        attr_writer :powerpoint
+
+        # Office Agent activity metrics for a single user on a given day within one Office
+        # product.
+        sig { returns(Anthropic::Organization::AnalyticsOfficeProductMetrics) }
+        attr_reader :word
+
+        sig do
+          params(
+            word: Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash
+          ).void
+        end
+        attr_writer :word
+
+        # Office Agent activity metrics for a single user on a given day, broken out by
+        # Office product.
+        sig do
+          params(
+            excel:
+              Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash,
+            outlook:
+              Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash,
+            powerpoint:
+              Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash,
+            word: Anthropic::Organization::AnalyticsOfficeProductMetrics::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Office Agent activity metrics for a single user on a given day within one Office
+          # product.
+          excel:,
+          # Office Agent activity metrics for a single user on a given day within one Office
+          # product.
+          outlook:,
+          # Office Agent activity metrics for a single user on a given day within one Office
+          # product.
+          powerpoint:,
+          # Office Agent activity metrics for a single user on a given day within one Office
+          # product.
+          word:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              excel: Anthropic::Organization::AnalyticsOfficeProductMetrics,
+              outlook: Anthropic::Organization::AnalyticsOfficeProductMetrics,
+              powerpoint:
+                Anthropic::Organization::AnalyticsOfficeProductMetrics,
+              word: Anthropic::Organization::AnalyticsOfficeProductMetrics
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_office_product_metrics.rbi

@@ -0,0 +1,96 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsOfficeProductMetrics < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsOfficeProductMetrics,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Number of MCP connector invocations
+        sig { returns(Integer) }
+        attr_accessor :connectors_used_count
+
+        # Number of distinct MCP connectors used. Approximate (HLL, typical error <2%) in
+        # date-range mode. Null on aggregated rows where a distinct count cannot be
+        # computed.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_connectors_used_count
+
+        # Number of distinct Office Agent sessions. Approximate (HLL, typical error <2%)
+        # in date-range mode. Null on aggregated rows where a distinct count cannot be
+        # computed.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_session_count
+
+        # Number of distinct skills used. Approximate (HLL, typical error <2%) in
+        # date-range mode. Null on aggregated rows where a distinct count cannot be
+        # computed.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_skills_used_count
+
+        # Number of messages sent
+        sig { returns(Integer) }
+        attr_accessor :message_count
+
+        # Number of skill invocations
+        sig { returns(Integer) }
+        attr_accessor :skills_used_count
+
+        # Office Agent activity metrics for a single user on a given day within one Office
+        # product.
+        sig do
+          params(
+            connectors_used_count: Integer,
+            distinct_connectors_used_count: T.nilable(Integer),
+            distinct_session_count: T.nilable(Integer),
+            distinct_skills_used_count: T.nilable(Integer),
+            message_count: Integer,
+            skills_used_count: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Number of MCP connector invocations
+          connectors_used_count:,
+          # Number of distinct MCP connectors used. Approximate (HLL, typical error <2%) in
+          # date-range mode. Null on aggregated rows where a distinct count cannot be
+          # computed.
+          distinct_connectors_used_count:,
+          # Number of distinct Office Agent sessions. Approximate (HLL, typical error <2%)
+          # in date-range mode. Null on aggregated rows where a distinct count cannot be
+          # computed.
+          distinct_session_count:,
+          # Number of distinct skills used. Approximate (HLL, typical error <2%) in
+          # date-range mode. Null on aggregated rows where a distinct count cannot be
+          # computed.
+          distinct_skills_used_count:,
+          # Number of messages sent
+          message_count:,
+          # Number of skill invocations
+          skills_used_count:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              connectors_used_count: Integer,
+              distinct_connectors_used_count: T.nilable(Integer),
+              distinct_session_count: T.nilable(Integer),
+              distinct_skills_used_count: T.nilable(Integer),
+              message_count: Integer,
+              skills_used_count: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_order.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      # Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort
+      # column and to `desc` when `order_by` names a metric (a top-N ranking). Applies
+      # to `order_by`, or to the endpoint's default sort field when `order_by` is
+      # omitted.
+      module AnalyticsOrder
+        extend Anthropic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Anthropic::Organization::AnalyticsOrder)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ASC = T.let(:asc, Anthropic::Organization::AnalyticsOrder::TaggedSymbol)
+        DESC =
+          T.let(:desc, Anthropic::Organization::AnalyticsOrder::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Anthropic::Organization::AnalyticsOrder::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_plugin_activity.rbi

@@ -0,0 +1,226 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginActivity < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsPluginActivity,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Claude Code activity metrics for a single plugin on a given day.
+        sig do
+          returns(Anthropic::Organization::AnalyticsPluginClaudeCodeMetrics)
+        end
+        attr_reader :claude_code_metrics
+
+        sig do
+          params(
+            claude_code_metrics:
+              Anthropic::Organization::AnalyticsPluginClaudeCodeMetrics::OrHash
+          ).void
+        end
+        attr_writer :claude_code_metrics
+
+        # Cowork activity metrics for a single plugin on a given day.
+        sig { returns(Anthropic::Organization::AnalyticsPluginCoworkMetrics) }
+        attr_reader :cowork_metrics
+
+        sig do
+          params(
+            cowork_metrics:
+              Anthropic::Organization::AnalyticsPluginCoworkMetrics::OrHash
+          ).void
+        end
+        attr_writer :cowork_metrics
+
+        # Number of distinct users with recorded install or invocation activity for the
+        # plugin on the requested day (install-only users count), or, in date-range mode,
+        # over the requested window — recomputed as an exact distinct count over the
+        # window's per-member daily rows, never a sum of per-day values.
+        sig { returns(Integer) }
+        attr_accessor :distinct_user_count
+
+        # Number of distinct users who installed the plugin on the requested day, or, in
+        # date-range mode, over the requested window — recomputed as an exact distinct
+        # count over the window's per-member daily rows, never a sum of per-day values.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :install_count
+
+        # Number of plugin invocations on the requested day
+        sig { returns(Integer) }
+        attr_accessor :invocation_count
+
+        # Stable plugin identifier when available (e.g. `serena@claude-plugins-official`).
+        # Null for third-party Claude Code plugins (redacted at the source) and Cowork
+        # slash commands that carry only a hashed id.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :plugin_id
+
+        # Name of the plugin
+        sig { returns(String) }
+        attr_accessor :plugin_name
+
+        # Plugin use recorded while members had Chat and Cowork unified (Cowork's features
+        # inside claude.ai chat) turned on. A count is null in date-range mode where it
+        # cannot be computed. Omitted from the response on deployments that do not offer
+        # Chat and Cowork unified.
+        sig do
+          returns(
+            T.nilable(
+              Anthropic::Organization::AnalyticsPluginChatCoworkUnifiedMetrics
+            )
+          )
+        end
+        attr_reader :chat_cowork_unified_metrics
+
+        sig do
+          params(
+            chat_cowork_unified_metrics:
+              T.nilable(
+                Anthropic::Organization::AnalyticsPluginChatCoworkUnifiedMetrics::OrHash
+              )
+          ).void
+        end
+        attr_writer :chat_cowork_unified_metrics
+
+        # Product that produced this row's activity: one of `chat`, `claude_code`,
+        # `cowork`, `office_agent`, or `chat_cowork_unified` (Chat and Cowork unified).
+        # These are the canonical Cost & Usage product names; an `office_agent` row's
+        # per-surface breakdown is in its `office_metrics`. On `/plugins` only `cowork`,
+        # `claude_code` and `chat_cowork_unified` occur (the only surfaces with plugin
+        # attribution); on `/artifacts` only `chat`, `claude_code`, `cowork` and
+        # `chat_cowork_unified` occur (the surfaces that create artifacts);
+        # `/apps/chat/projects` does not support the product dimension (a `product` entry
+        # in `group_by[]` or `filter[]` there is rejected). Present only when the request
+        # grouped by `product`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :product
+
+        # Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API
+        # spelling. Present only when the request grouped by `rbac_group_id`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :rbac_group_id
+
+        # Resolved RBAC group display name, alongside `rbac_group_id` when name resolution
+        # is available. Null if the group has been deleted or its name could not be
+        # resolved; `rbac_group_id` remains the stable key.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :rbac_group_name
+
+        # Tagged user identifier (e.g. `user_...`). Present only when the request grouped
+        # by `user_id`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :user_id
+
+        # Per-plugin install + invocation activity for a given day.
+        #
+        # With `group_by[]=user_id` / `rbac_group_id` / `product` (`cowork`, `claude_code`
+        # and `chat_cowork_unified` only on this endpoint) each row is one (plugin, user),
+        # (plugin, group), or (plugin, product) cut: the flat `user_id` / `rbac_group_id`
+        # / `product` keys carry the cut and the counts are scoped to it.
+        sig do
+          params(
+            claude_code_metrics:
+              Anthropic::Organization::AnalyticsPluginClaudeCodeMetrics::OrHash,
+            cowork_metrics:
+              Anthropic::Organization::AnalyticsPluginCoworkMetrics::OrHash,
+            distinct_user_count: Integer,
+            install_count: T.nilable(Integer),
+            invocation_count: Integer,
+            plugin_id: T.nilable(String),
+            plugin_name: String,
+            chat_cowork_unified_metrics:
+              T.nilable(
+                Anthropic::Organization::AnalyticsPluginChatCoworkUnifiedMetrics::OrHash
+              ),
+            product: T.nilable(String),
+            rbac_group_id: T.nilable(String),
+            rbac_group_name: T.nilable(String),
+            user_id: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Claude Code activity metrics for a single plugin on a given day.
+          claude_code_metrics:,
+          # Cowork activity metrics for a single plugin on a given day.
+          cowork_metrics:,
+          # Number of distinct users with recorded install or invocation activity for the
+          # plugin on the requested day (install-only users count), or, in date-range mode,
+          # over the requested window — recomputed as an exact distinct count over the
+          # window's per-member daily rows, never a sum of per-day values.
+          distinct_user_count:,
+          # Number of distinct users who installed the plugin on the requested day, or, in
+          # date-range mode, over the requested window — recomputed as an exact distinct
+          # count over the window's per-member daily rows, never a sum of per-day values.
+          install_count:,
+          # Number of plugin invocations on the requested day
+          invocation_count:,
+          # Stable plugin identifier when available (e.g. `serena@claude-plugins-official`).
+          # Null for third-party Claude Code plugins (redacted at the source) and Cowork
+          # slash commands that carry only a hashed id.
+          plugin_id:,
+          # Name of the plugin
+          plugin_name:,
+          # Plugin use recorded while members had Chat and Cowork unified (Cowork's features
+          # inside claude.ai chat) turned on. A count is null in date-range mode where it
+          # cannot be computed. Omitted from the response on deployments that do not offer
+          # Chat and Cowork unified.
+          chat_cowork_unified_metrics: nil,
+          # Product that produced this row's activity: one of `chat`, `claude_code`,
+          # `cowork`, `office_agent`, or `chat_cowork_unified` (Chat and Cowork unified).
+          # These are the canonical Cost & Usage product names; an `office_agent` row's
+          # per-surface breakdown is in its `office_metrics`. On `/plugins` only `cowork`,
+          # `claude_code` and `chat_cowork_unified` occur (the only surfaces with plugin
+          # attribution); on `/artifacts` only `chat`, `claude_code`, `cowork` and
+          # `chat_cowork_unified` occur (the surfaces that create artifacts);
+          # `/apps/chat/projects` does not support the product dimension (a `product` entry
+          # in `group_by[]` or `filter[]` there is rejected). Present only when the request
+          # grouped by `product`.
+          product: nil,
+          # Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API
+          # spelling. Present only when the request grouped by `rbac_group_id`.
+          rbac_group_id: nil,
+          # Resolved RBAC group display name, alongside `rbac_group_id` when name resolution
+          # is available. Null if the group has been deleted or its name could not be
+          # resolved; `rbac_group_id` remains the stable key.
+          rbac_group_name: nil,
+          # Tagged user identifier (e.g. `user_...`). Present only when the request grouped
+          # by `user_id`.
+          user_id: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              claude_code_metrics:
+                Anthropic::Organization::AnalyticsPluginClaudeCodeMetrics,
+              cowork_metrics:
+                Anthropic::Organization::AnalyticsPluginCoworkMetrics,
+              distinct_user_count: Integer,
+              install_count: T.nilable(Integer),
+              invocation_count: Integer,
+              plugin_id: T.nilable(String),
+              plugin_name: String,
+              chat_cowork_unified_metrics:
+                T.nilable(
+                  Anthropic::Organization::AnalyticsPluginChatCoworkUnifiedMetrics
+                ),
+              product: T.nilable(String),
+              rbac_group_id: T.nilable(String),
+              rbac_group_name: T.nilable(String),
+              user_id: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_plugin_chat_cowork_unified_metrics.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginChatCoworkUnifiedMetrics < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsPluginChatCoworkUnifiedMetrics,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Same measure as `cowork_metrics.distinct_session_plugin_used_count`, for
+        # activity recorded while members had Chat and Cowork unified turned on. Null on
+        # aggregated rows where a distinct count cannot be computed.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_session_plugin_used_count
+
+        # A plugin's use in Cowork sessions recorded while members had Chat and Cowork
+        # unified turned on.
+        sig do
+          params(
+            distinct_session_plugin_used_count: T.nilable(Integer)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Same measure as `cowork_metrics.distinct_session_plugin_used_count`, for
+          # activity recorded while members had Chat and Cowork unified turned on. Null on
+          # aggregated rows where a distinct count cannot be computed.
+          distinct_session_plugin_used_count:
+        )
+        end
+
+        sig do
+          override.returns(
+            { distinct_session_plugin_used_count: T.nilable(Integer) }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_plugin_claude_code_metrics.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginClaudeCodeMetrics < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsPluginClaudeCodeMetrics,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Number of distinct Claude Code sessions in which the plugin was invoked. Null on
+        # aggregated rows where a distinct count cannot be computed.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_session_plugin_used_count
+
+        # Claude Code activity metrics for a single plugin on a given day.
+        sig do
+          params(
+            distinct_session_plugin_used_count: T.nilable(Integer)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Number of distinct Claude Code sessions in which the plugin was invoked. Null on
+          # aggregated rows where a distinct count cannot be computed.
+          distinct_session_plugin_used_count:
+        )
+        end
+
+        sig do
+          override.returns(
+            { distinct_session_plugin_used_count: T.nilable(Integer) }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_plugin_cowork_metrics.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginCoworkMetrics < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Organization::AnalyticsPluginCoworkMetrics,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Number of distinct Cowork sessions in which the plugin was invoked. Null on
+        # aggregated rows where a distinct count cannot be computed.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :distinct_session_plugin_used_count
+
+        # Cowork activity metrics for a single plugin on a given day.
+        sig do
+          params(
+            distinct_session_plugin_used_count: T.nilable(Integer)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Number of distinct Cowork sessions in which the plugin was invoked. Null on
+          # aggregated rows where a distinct count cannot be computed.
+          distinct_session_plugin_used_count:
+        )
+        end
+
+        sig do
+          override.returns(
+            { distinct_session_plugin_used_count: T.nilable(Integer) }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/organization/analytics_plugin_group_by.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    module Organization
+      # A dimension to group plugin activity by.
+      module AnalyticsPluginGroupBy
+        extend Anthropic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Anthropic::Organization::AnalyticsPluginGroupBy)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PRODUCT =
+          T.let(
+            :product,
+            Anthropic::Organization::AnalyticsPluginGroupBy::TaggedSymbol
+          )
+        RBAC_GROUP_ID =
+          T.let(
+            :rbac_group_id,
+            Anthropic::Organization::AnalyticsPluginGroupBy::TaggedSymbol
+          )
+        USER_ID =
+          T.let(
+            :user_id,
+            Anthropic::Organization::AnalyticsPluginGroupBy::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Anthropic::Organization::AnalyticsPluginGroupBy::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end