anthropic 2.2.0 → 2.4.0

data/lib/anthropic/models/beta/organization/beta_analytics_connector_activity.rb

@@ -18,6 +18,21 @@ module Anthropic
           required :claude_code_metrics,
                    -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorClaudeCodeMetrics }
 
+          # @!attribute connector_display_name
+          #   Human-readable display name for rows whose `connector_name` is an opaque
+          #   connector id rather than a readable name, resolved at request time from the
+          #   organization's connectors (including connectors that have since been removed).
+          #   `connector_name` remains the row's stable key for sorting and pagination, and
+          #   `filter[]=connector_name:{value}` also matches these rows by display name.
+          #   Display names are not unique, and the same connector's claude.ai usage can
+          #   appear under a separate row with a readable `connector_name`. Null when
+          #   `connector_name` is already a readable name, when the id cannot be resolved to
+          #   one of the organization's connectors, or when display-name resolution is not
+          #   enabled for this organization.
+          #
+          #   @return [String, nil]
+          required :connector_display_name, String, nil?: true
+
           # @!attribute connector_name
           #   Name of the connector. Some rows carry an opaque connector id here instead of a
           #   readable name; `connector_display_name` holds the resolved name for those rows.
@@ -39,42 +54,6 @@ module Anthropic
           #   @return [Integer]
           required :distinct_user_count, Integer
 
-          # @!attribute office_metrics
-          #   Office Agent activity metrics for a single connector on a given day, broken out
-          #   by Office product.
-          #
-          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics]
-          required :office_metrics, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics }
-
-          # @!attribute chat_cowork_unified_metrics
-          #   Connector use recorded while members had Chat and Cowork unified (Cowork's
-          #   features inside claude.ai chat) turned on, split into chat conversations and
-          #   Cowork sessions. 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.
-          #
-          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorActivity::ChatCoworkUnifiedMetrics, nil]
-          optional :chat_cowork_unified_metrics,
-                   -> {
-                     Anthropic::Beta::Organization::BetaAnalyticsConnectorActivity::ChatCoworkUnifiedMetrics
-                   },
-                   nil?: true
-
-          # @!attribute connector_display_name
-          #   Human-readable display name for rows whose `connector_name` is an opaque
-          #   connector id rather than a readable name, resolved at request time from the
-          #   organization's connectors (including connectors that have since been removed).
-          #   `connector_name` remains the row's stable key for sorting and pagination, and
-          #   `filter[]=connector_name:{value}` also matches these rows by display name.
-          #   Display names are not unique, and the same connector's claude.ai usage can
-          #   appear under a separate row with a readable `connector_name`. Null when
-          #   `connector_name` is already a readable name, when the id cannot be resolved to
-          #   one of the organization's connectors, or when display-name resolution is not
-          #   enabled for this organization.
-          #
-          #   @return [String, nil]
-          optional :connector_display_name, String, nil?: true
-
           # @!attribute individual_auth_distinct_user_count
           #   Number of distinct users whose use of this connector on the requested day ran on
           #   their own individual credential, connected through their own consent flow.
@@ -83,7 +62,7 @@ module Anthropic
           #   credential count in neither bucket.
           #
           #   @return [Integer, nil]
-          optional :individual_auth_distinct_user_count, Integer, nil?: true
+          required :individual_auth_distinct_user_count, Integer, nil?: true
 
           # @!attribute managed_auth_distinct_user_count
           #   Number of distinct users whose use of this connector on the requested day ran on
@@ -109,37 +88,14 @@ module Anthropic
           #   partial-window value.
           #
           #   @return [Integer, nil]
-          optional :managed_auth_distinct_user_count, Integer, nil?: true
-
-          # @!attribute product
-          #   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`.
-          #
-          #   @return [String, nil]
-          optional :product, String, nil?: true
-
-          # @!attribute rbac_group_id
-          #   Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API
-          #   spelling. Present only when the request grouped by `rbac_group_id`.
-          #
-          #   @return [String, nil]
-          optional :rbac_group_id, String, nil?: true
+          required :managed_auth_distinct_user_count, Integer, nil?: true
 
-          # @!attribute rbac_group_name
-          #   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.
+          # @!attribute office_metrics
+          #   Office Agent activity metrics for a single connector on a given day, broken out
+          #   by Office product.
           #
-          #   @return [String, nil]
-          optional :rbac_group_name, String, nil?: true
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics]
+          required :office_metrics, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics }
 
           # @!attribute read_call_count
           #   Number of connector tool calls on the requested day whose trusted read-only
@@ -157,7 +113,7 @@ module Anthropic
           #   server-side.
           #
           #   @return [Integer, nil]
-          optional :read_call_count, Integer, nil?: true
+          required :read_call_count, Integer, nil?: true
 
           # @!attribute unclassified_call_count
           #   Number of connector tool calls on the requested day with no trusted read-only
@@ -169,14 +125,7 @@ module Anthropic
           #   data-start dates, null conditions, and date-range guidance.
           #
           #   @return [Integer, nil]
-          optional :unclassified_call_count, Integer, nil?: true
-
-          # @!attribute user_id
-          #   Tagged user identifier (e.g. `user_...`). Present only when the request grouped
-          #   by `user_id`.
-          #
-          #   @return [String, nil]
-          optional :user_id, String, nil?: true
+          required :unclassified_call_count, Integer, nil?: true
 
           # @!attribute write_call_count
           #   Number of connector tool calls on the requested day whose trusted read-only
@@ -185,9 +134,58 @@ module Anthropic
           #   data-start dates, null conditions, and date-range guidance.
           #
           #   @return [Integer, nil]
-          optional :write_call_count, Integer, nil?: true
+          required :write_call_count, Integer, nil?: true
+
+          # @!attribute chat_cowork_unified_metrics
+          #   Connector use recorded while members had Chat and Cowork unified (Cowork's
+          #   features inside claude.ai chat) turned on, split into chat conversations and
+          #   Cowork sessions. 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.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedMetrics, nil]
+          optional :chat_cowork_unified_metrics,
+                   -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedMetrics },
+                   nil?: true
+
+          # @!attribute product
+          #   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`.
+          #
+          #   @return [String, nil]
+          optional :product, String, nil?: true
+
+          # @!attribute rbac_group_id
+          #   Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API
+          #   spelling. Present only when the request grouped by `rbac_group_id`.
+          #
+          #   @return [String, nil]
+          optional :rbac_group_id, String, nil?: true
+
+          # @!attribute rbac_group_name
+          #   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.
+          #
+          #   @return [String, nil]
+          optional :rbac_group_name, String, nil?: true
 
-          # @!method initialize(chat_metrics:, claude_code_metrics:, connector_name:, cowork_metrics:, distinct_user_count:, office_metrics:, chat_cowork_unified_metrics: nil, connector_display_name: nil, individual_auth_distinct_user_count: nil, managed_auth_distinct_user_count: nil, product: nil, rbac_group_id: nil, rbac_group_name: nil, read_call_count: nil, unclassified_call_count: nil, user_id: nil, write_call_count: nil)
+          # @!attribute user_id
+          #   Tagged user identifier (e.g. `user_...`). Present only when the request grouped
+          #   by `user_id`.
+          #
+          #   @return [String, nil]
+          optional :user_id, String, nil?: true
+
+          # @!method initialize(chat_metrics:, claude_code_metrics:, connector_display_name:, connector_name:, cowork_metrics:, distinct_user_count:, individual_auth_distinct_user_count:, managed_auth_distinct_user_count:, office_metrics:, read_call_count:, unclassified_call_count:, write_call_count:, chat_cowork_unified_metrics: nil, product: nil, rbac_group_id: nil, rbac_group_name: nil, user_id: nil)
           #   Per-connector activity data for a given day.
           #
           #   Some parameter documentations has been truncated, see
@@ -198,21 +196,27 @@ module Anthropic
           #
           #   @param claude_code_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorClaudeCodeMetrics] Claude Code activity metrics for a single connector on a given day.
           #
+          #   @param connector_display_name [String, nil] Human-readable display name for rows whose `connector_name` is an opaque connect
+          #
           #   @param connector_name [String] Name of the connector. Some rows carry an opaque connector id here instead of a
           #
           #   @param cowork_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorCoworkMetrics] Cowork activity metrics for a single connector on a given day.
           #
           #   @param distinct_user_count [Integer] Number of distinct users who used the connector on the requested day, or, in dat
           #
+          #   @param individual_auth_distinct_user_count [Integer, nil] Number of distinct users whose use of this connector on the requested day ran on
+          #
+          #   @param managed_auth_distinct_user_count [Integer, nil] Number of distinct users whose use of this connector on the requested day ran on
+          #
           #   @param office_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics] Office Agent activity metrics for a single connector on a given day, broken out
           #
-          #   @param chat_cowork_unified_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorActivity::ChatCoworkUnifiedMetrics, nil] Connector use recorded while members had Chat and Cowork unified (Cowork's featu
+          #   @param read_call_count [Integer, nil] Number of connector tool calls on the requested day whose trusted read-only anno
           #
-          #   @param connector_display_name [String, nil] Human-readable display name for rows whose `connector_name` is an opaque connect
+          #   @param unclassified_call_count [Integer, nil] Number of connector tool calls on the requested day with no trusted read-only an
           #
-          #   @param individual_auth_distinct_user_count [Integer, nil] Number of distinct users whose use of this connector on the requested day ran on
+          #   @param write_call_count [Integer, nil] Number of connector tool calls on the requested day whose trusted read-only anno
           #
-          #   @param managed_auth_distinct_user_count [Integer, nil] Number of distinct users whose use of this connector on the requested day ran on
+          #   @param chat_cowork_unified_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedMetrics, nil] Connector use recorded while members had Chat and Cowork unified (Cowork's featu
           #
           #   @param product [String, nil] Product that produced this row's activity: one of `chat`, `claude_code`, `cowork
           #
@@ -220,46 +224,7 @@ module Anthropic
           #
           #   @param rbac_group_name [String, nil] Resolved RBAC group display name, alongside `rbac_group_id` when name resolution
           #
-          #   @param read_call_count [Integer, nil] Number of connector tool calls on the requested day whose trusted read-only anno
-          #
-          #   @param unclassified_call_count [Integer, nil] Number of connector tool calls on the requested day with no trusted read-only an
-          #
           #   @param user_id [String, nil] Tagged user identifier (e.g. `user_...`). Present only when the request grouped
-          #
-          #   @param write_call_count [Integer, nil] Number of connector tool calls on the requested day whose trusted read-only anno
-
-          # @see Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorActivity#chat_cowork_unified_metrics
-          class ChatCoworkUnifiedMetrics < Anthropic::Internal::Type::BaseModel
-            # @!attribute chat
-            #   A connector's use in chat conversations recorded while members had Chat and
-            #   Cowork unified turned on.
-            #
-            #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics]
-            required :chat, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics }
-
-            # @!attribute sessions
-            #   A connector's use in Cowork sessions recorded while members had Chat and Cowork
-            #   unified turned on.
-            #
-            #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics]
-            required :sessions,
-                     -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics }
-
-            # @!method initialize(chat:, sessions:)
-            #   Connector use recorded while members had Chat and Cowork unified (Cowork's
-            #   features inside claude.ai chat) turned on, split into chat conversations and
-            #   Cowork sessions. 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.
-            #
-            #   Some parameter documentations has been truncated, see
-            #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorActivity::ChatCoworkUnifiedMetrics}
-            #   for more details.
-            #
-            #   @param chat [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics] A connector's use in chat conversations recorded while members had
-            #
-            #   @param sessions [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics] A connector's use in Cowork sessions recorded while members had
-          end
         end
       end
     end

data/lib/anthropic/models/beta/organization/beta_analytics_connector_chat_cowork_unified_metrics.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorChatCoworkUnifiedMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute chat
+          #   A connector's use in chat conversations recorded while members had Chat and
+          #   Cowork unified turned on.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics]
+          required :chat, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics }
+
+          # @!attribute sessions
+          #   A connector's use in Cowork sessions recorded while members had Chat and Cowork
+          #   unified turned on.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics]
+          required :sessions,
+                   -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics }
+
+          # @!method initialize(chat:, sessions:)
+          #   A connector's use in Chat and Cowork unified on one day: `chat` holds its use in
+          #   chat conversations and `sessions` its use in Cowork sessions.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedMetrics}
+          #   for more details.
+          #
+          #   @param chat [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics] A connector's use in chat conversations recorded while members had
+          #
+          #   @param sessions [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics] A connector's use in Cowork sessions recorded while members had
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_connector_group_by.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        # A dimension to group connector activity by.
+        module BetaAnalyticsConnectorGroupBy
+          extend Anthropic::Internal::Type::Enum
+
+          PRODUCT = :product
+          RBAC_GROUP_ID = :rbac_group_id
+          USER_ID = :user_id
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_cowork_metrics.rb

@@ -41,6 +41,15 @@ module Anthropic
           #   @return [Integer, nil]
           required :distinct_connectors_used_count, Integer, nil?: true
 
+          # @!attribute distinct_plugins_used_count
+          #   Number of distinct plugins used in Cowork sessions. Null while Cowork plugin-use
+          #   metrics are not enabled for this organization. Approximate (HLL, typical error
+          #   <2%) in date-range mode. Null on aggregated rows where a distinct count cannot
+          #   be computed.
+          #
+          #   @return [Integer, nil]
+          required :distinct_plugins_used_count, Integer, nil?: true
+
           # @!attribute distinct_session_count
           #   Number of distinct Cowork sessions. Approximate (HLL, typical error <2%) in
           #   date-range mode. Null on aggregated rows where a distinct count cannot be
@@ -57,33 +66,12 @@ module Anthropic
           #   @return [Integer, nil]
           required :distinct_skills_used_count, Integer, nil?: true
 
-          # @!attribute message_count
-          #   Number of messages sent in Cowork sessions
-          #
-          #   @return [Integer]
-          required :message_count, Integer
-
-          # @!attribute skills_used_count
-          #   Total number of skill invocations in Cowork sessions
-          #
-          #   @return [Integer]
-          required :skills_used_count, Integer
-
-          # @!attribute distinct_plugins_used_count
-          #   Number of distinct plugins used in Cowork sessions. Null while Cowork plugin-use
-          #   metrics are not enabled for this organization. Approximate (HLL, typical error
-          #   <2%) in date-range mode. Null on aggregated rows where a distinct count cannot
-          #   be computed.
-          #
-          #   @return [Integer, nil]
-          optional :distinct_plugins_used_count, Integer, nil?: true
-
           # @!attribute edit_tool_count
           #   Number of successful Edit tool calls in Cowork sessions. Null while the
           #   file-edit metrics are not enabled for this organization.
           #
           #   @return [Integer, nil]
-          optional :edit_tool_count, Integer, nil?: true
+          required :edit_tool_count, Integer, nil?: true
 
           # @!attribute file_edit_count
           #   Number of successful file-edit tool calls (Edit, MultiEdit, Write, NotebookEdit)
@@ -91,28 +79,34 @@ module Anthropic
           #   for this organization.
           #
           #   @return [Integer, nil]
-          optional :file_edit_count, Integer, nil?: true
+          required :file_edit_count, Integer, nil?: true
+
+          # @!attribute message_count
+          #   Number of messages sent in Cowork sessions
+          #
+          #   @return [Integer]
+          required :message_count, Integer
 
           # @!attribute multi_edit_tool_count
           #   Number of successful MultiEdit tool calls in Cowork sessions. Null while the
           #   file-edit metrics are not enabled for this organization.
           #
           #   @return [Integer, nil]
-          optional :multi_edit_tool_count, Integer, nil?: true
+          required :multi_edit_tool_count, Integer, nil?: true
 
           # @!attribute notebook_edit_tool_count
           #   Number of successful NotebookEdit tool calls in Cowork sessions. Null while the
           #   file-edit metrics are not enabled for this organization.
           #
           #   @return [Integer, nil]
-          optional :notebook_edit_tool_count, Integer, nil?: true
+          required :notebook_edit_tool_count, Integer, nil?: true
 
           # @!attribute plugins_used_count
           #   Total number of plugin invocations in Cowork sessions. Null while Cowork
           #   plugin-use metrics are not enabled for this organization.
           #
           #   @return [Integer, nil]
-          optional :plugins_used_count, Integer, nil?: true
+          required :plugins_used_count, Integer, nil?: true
 
           # @!attribute sessions_with_file_edits_count
           #   Number of distinct Cowork sessions with at least one successful file-edit tool
@@ -121,16 +115,22 @@ module Anthropic
           #   where a distinct count cannot be computed.
           #
           #   @return [Integer, nil]
-          optional :sessions_with_file_edits_count, Integer, nil?: true
+          required :sessions_with_file_edits_count, Integer, nil?: true
+
+          # @!attribute skills_used_count
+          #   Total number of skill invocations in Cowork sessions
+          #
+          #   @return [Integer]
+          required :skills_used_count, Integer
 
           # @!attribute write_tool_count
           #   Number of successful Write tool calls in Cowork sessions. Null while the
           #   file-edit metrics are not enabled for this organization.
           #
           #   @return [Integer, nil]
-          optional :write_tool_count, Integer, nil?: true
+          required :write_tool_count, Integer, nil?: true
 
-          # @!method initialize(action_count:, artifacts_created_count:, connectors_used_count:, dispatch_turn_count:, distinct_connectors_used_count:, distinct_session_count:, distinct_skills_used_count:, message_count:, skills_used_count:, distinct_plugins_used_count: nil, edit_tool_count: nil, file_edit_count: nil, multi_edit_tool_count: nil, notebook_edit_tool_count: nil, plugins_used_count: nil, sessions_with_file_edits_count: nil, write_tool_count: nil)
+          # @!method initialize(action_count:, artifacts_created_count:, connectors_used_count:, dispatch_turn_count:, distinct_connectors_used_count:, distinct_plugins_used_count:, distinct_session_count:, distinct_skills_used_count:, edit_tool_count:, file_edit_count:, message_count:, multi_edit_tool_count:, notebook_edit_tool_count:, plugins_used_count:, sessions_with_file_edits_count:, skills_used_count:, write_tool_count:)
           #   Cowork activity metrics for a single user on a given day.
           #
           #   Some parameter documentations has been truncated, see
@@ -147,20 +147,18 @@ module Anthropic
           #
           #   @param distinct_connectors_used_count [Integer, nil] Number of distinct connectors used in Cowork sessions. Approximate (HLL, typical
           #
+          #   @param distinct_plugins_used_count [Integer, nil] Number of distinct plugins used in Cowork sessions. Null while Cowork plugin-use
+          #
           #   @param distinct_session_count [Integer, nil] Number of distinct Cowork sessions. Approximate (HLL, typical error <2%) in date
           #
           #   @param distinct_skills_used_count [Integer, nil] Number of distinct skills used in Cowork sessions. Approximate (HLL, typical err
           #
-          #   @param message_count [Integer] Number of messages sent in Cowork sessions
-          #
-          #   @param skills_used_count [Integer] Total number of skill invocations in Cowork sessions
-          #
-          #   @param distinct_plugins_used_count [Integer, nil] Number of distinct plugins used in Cowork sessions. Null while Cowork plugin-use
-          #
           #   @param edit_tool_count [Integer, nil] Number of successful Edit tool calls in Cowork sessions. Null while the file-edi
           #
           #   @param file_edit_count [Integer, nil] Number of successful file-edit tool calls (Edit, MultiEdit, Write, NotebookEdit)
           #
+          #   @param message_count [Integer] Number of messages sent in Cowork sessions
+          #
           #   @param multi_edit_tool_count [Integer, nil] Number of successful MultiEdit tool calls in Cowork sessions. Null while the fil
           #
           #   @param notebook_edit_tool_count [Integer, nil] Number of successful NotebookEdit tool calls in Cowork sessions. Null while the
@@ -169,6 +167,8 @@ module Anthropic
           #
           #   @param sessions_with_file_edits_count [Integer, nil] Number of distinct Cowork sessions with at least one successful file-edit tool c
           #
+          #   @param skills_used_count [Integer] Total number of skill invocations in Cowork sessions
+          #
           #   @param write_tool_count [Integer, nil] Number of successful Write tool calls in Cowork sessions. Null while the file-ed
         end
       end

data/lib/anthropic/models/beta/organization/beta_analytics_order.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      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 BetaAnalyticsOrder
+          extend Anthropic::Internal::Type::Enum
+
+          ASC = :asc
+          DESC = :desc
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_plugin_activity.rb

@@ -40,6 +40,14 @@ module Anthropic
           #   @return [Integer]
           required :invocation_count, Integer
 
+          # @!attribute plugin_id
+          #   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.
+          #
+          #   @return [String, nil]
+          required :plugin_id, String, nil?: true
+
           # @!attribute plugin_name
           #   Name of the plugin
           #
@@ -52,21 +60,11 @@ module Anthropic
           #   cannot be computed. Omitted from the response on deployments that do not offer
           #   Chat and Cowork unified.
           #
-          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsPluginActivity::ChatCoworkUnifiedMetrics, nil]
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsPluginChatCoworkUnifiedMetrics, nil]
           optional :chat_cowork_unified_metrics,
-                   -> {
-                     Anthropic::Beta::Organization::BetaAnalyticsPluginActivity::ChatCoworkUnifiedMetrics
-                   },
+                   -> { Anthropic::Beta::Organization::BetaAnalyticsPluginChatCoworkUnifiedMetrics },
                    nil?: true
 
-          # @!attribute plugin_id
-          #   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.
-          #
-          #   @return [String, nil]
-          optional :plugin_id, String, nil?: true
-
           # @!attribute product
           #   Product that produced this row's activity: one of `chat`, `claude_code`,
           #   `cowork`, `office_agent`, or `chat_cowork_unified` (Chat and Cowork unified).
@@ -104,7 +102,7 @@ module Anthropic
           #   @return [String, nil]
           optional :user_id, String, nil?: true
 
-          # @!method initialize(claude_code_metrics:, cowork_metrics:, distinct_user_count:, install_count:, invocation_count:, plugin_name:, chat_cowork_unified_metrics: nil, plugin_id: nil, product: nil, rbac_group_id: nil, rbac_group_name: nil, user_id: nil)
+          # @!method initialize(claude_code_metrics:, cowork_metrics:, distinct_user_count:, install_count:, invocation_count:, plugin_id:, plugin_name:, chat_cowork_unified_metrics: nil, product: nil, rbac_group_id: nil, rbac_group_name: nil, user_id: nil)
           #   Per-plugin install + invocation activity for a given day.
           #
           #   With `group_by[]=user_id` / `rbac_group_id` / `product` (`cowork`, `claude_code`
@@ -126,11 +124,11 @@ module Anthropic
           #
           #   @param invocation_count [Integer] Number of plugin invocations on the requested day
           #
-          #   @param plugin_name [String] Name of the plugin
+          #   @param plugin_id [String, nil] Stable plugin identifier when available (e.g. `serena@claude-plugins-official`).
           #
-          #   @param chat_cowork_unified_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsPluginActivity::ChatCoworkUnifiedMetrics, nil] Plugin use recorded while members had Chat and Cowork unified (Cowork's features
+          #   @param plugin_name [String] Name of the plugin
           #
-          #   @param plugin_id [String, nil] Stable plugin identifier when available (e.g. `serena@claude-plugins-official`).
+          #   @param chat_cowork_unified_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsPluginChatCoworkUnifiedMetrics, nil] Plugin use recorded while members had Chat and Cowork unified (Cowork's features
           #
           #   @param product [String, nil] Product that produced this row's activity: one of `chat`, `claude_code`, `cowork
           #
@@ -139,29 +137,6 @@ module Anthropic
           #   @param rbac_group_name [String, nil] Resolved RBAC group display name, alongside `rbac_group_id` when name resolution
           #
           #   @param user_id [String, nil] Tagged user identifier (e.g. `user_...`). Present only when the request grouped
-
-          # @see Anthropic::Models::Beta::Organization::BetaAnalyticsPluginActivity#chat_cowork_unified_metrics
-          class ChatCoworkUnifiedMetrics < Anthropic::Internal::Type::BaseModel
-            # @!attribute distinct_session_plugin_used_count
-            #   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.
-            #
-            #   @return [Integer, nil]
-            required :distinct_session_plugin_used_count, Integer, nil?: true
-
-            # @!method initialize(distinct_session_plugin_used_count:)
-            #   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.
-            #
-            #   Some parameter documentations has been truncated, see
-            #   {Anthropic::Models::Beta::Organization::BetaAnalyticsPluginActivity::ChatCoworkUnifiedMetrics}
-            #   for more details.
-            #
-            #   @param distinct_session_plugin_used_count [Integer, nil] Same measure as `cowork_metrics.distinct_session_plugin_used_count`, for activit
-          end
         end
       end
     end

data/lib/anthropic/models/beta/organization/beta_analytics_plugin_chat_cowork_unified_metrics.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsPluginChatCoworkUnifiedMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute distinct_session_plugin_used_count
+          #   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.
+          #
+          #   @return [Integer, nil]
+          required :distinct_session_plugin_used_count, Integer, nil?: true
+
+          # @!method initialize(distinct_session_plugin_used_count:)
+          #   A plugin's use in Cowork sessions recorded while members had Chat and Cowork
+          #   unified turned on.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsPluginChatCoworkUnifiedMetrics}
+          #   for more details.
+          #
+          #   @param distinct_session_plugin_used_count [Integer, nil] Same measure as `cowork_metrics.distinct_session_plugin_used_count`, for activit
+        end
+      end
+    end
+  end
+end