anthropic 2.3.0 → 2.4.0

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

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        # A dimension to group plugin activity by.
+        module BetaAnalyticsPluginGroupBy
+          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_project_activity.rb

@@ -5,6 +5,27 @@ module Anthropic
     module Beta
       module Organization
         class BetaAnalyticsProjectActivity < Anthropic::Internal::Type::BaseModel
+          # @!attribute created_at
+          #   Project creation timestamp in RFC 3339 format. Null if the project was deleted
+          #   before attribution was recorded.
+          #
+          #   @return [Time, nil]
+          required :created_at, Time, nil?: true
+
+          # @!attribute created_by
+          #   User who created the project. Null if the project was deleted before attribution
+          #   was recorded, or if the creator's account no longer exists.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsUser, nil]
+          required :created_by, -> { Anthropic::Beta::Organization::BetaAnalyticsUser }, nil?: true
+
+          # @!attribute distinct_conversation_count
+          #   Number of distinct conversations in the project. Null on aggregated rows where a
+          #   distinct count cannot be computed.
+          #
+          #   @return [Integer, nil]
+          required :distinct_conversation_count, Integer, nil?: true
+
           # @!attribute distinct_user_count
           #   Number of distinct users who used the project on the requested day, or, in
           #   date-range mode, over the requested window — recomputed as an exact distinct
@@ -31,42 +52,6 @@ module Anthropic
           #   @return [String]
           required :project_name, String
 
-          # @!attribute created_at
-          #   Project creation timestamp in RFC 3339 format. Null if the project was deleted
-          #   before attribution was recorded.
-          #
-          #   @return [Time, nil]
-          optional :created_at, Time, nil?: true
-
-          # @!attribute created_by
-          #   User who created the project. Null if the project was deleted before attribution
-          #   was recorded, or if the creator's account no longer exists.
-          #
-          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsUser, nil]
-          optional :created_by, -> { Anthropic::Beta::Organization::BetaAnalyticsUser }, nil?: true
-
-          # @!attribute distinct_conversation_count
-          #   Number of distinct conversations in the project. Null on aggregated rows where a
-          #   distinct count cannot be computed.
-          #
-          #   @return [Integer, nil]
-          optional :distinct_conversation_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`.
@@ -89,13 +74,19 @@ module Anthropic
           #   @return [String, nil]
           optional :user_id, String, nil?: true
 
-          # @!method initialize(distinct_user_count:, message_count:, project_id:, project_name:, created_at: nil, created_by: nil, distinct_conversation_count: nil, product: nil, rbac_group_id: nil, rbac_group_name: nil, user_id: nil)
+          # @!method initialize(created_at:, created_by:, distinct_conversation_count:, distinct_user_count:, message_count:, project_id:, project_name:, rbac_group_id: nil, rbac_group_name: nil, user_id: nil)
           #   Per-project activity data for a given day.
           #
           #   Some parameter documentations has been truncated, see
           #   {Anthropic::Models::Beta::Organization::BetaAnalyticsProjectActivity} for more
           #   details.
           #
+          #   @param created_at [Time, nil] Project creation timestamp in RFC 3339 format. Null if the project was deleted b
+          #
+          #   @param created_by [Anthropic::Models::Beta::Organization::BetaAnalyticsUser, nil] User who created the project. Null if the project was deleted before attribution
+          #
+          #   @param distinct_conversation_count [Integer, nil] Number of distinct conversations in the project. Null on aggregated rows where a
+          #
           #   @param distinct_user_count [Integer] Number of distinct users who used the project on the requested day, or, in date-
           #
           #   @param message_count [Integer] Number of messages sent in the project on the requested day
@@ -104,14 +95,6 @@ module Anthropic
           #
           #   @param project_name [String] Name of the project
           #
-          #   @param created_at [Time, nil] Project creation timestamp in RFC 3339 format. Null if the project was deleted b
-          #
-          #   @param created_by [Anthropic::Models::Beta::Organization::BetaAnalyticsUser, nil] User who created the project. Null if the project was deleted before attribution
-          #
-          #   @param distinct_conversation_count [Integer, nil] Number of distinct conversations in the project. Null on aggregated rows where a
-          #
-          #   @param product [String, nil] Product that produced this row's activity: one of `chat`, `claude_code`, `cowork
-          #
           #   @param rbac_group_id [String, nil] Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API s
           #
           #   @param rbac_group_name [String, nil] Resolved RBAC group display name, alongside `rbac_group_id` when name resolution

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

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