anthropic 2.3.0 → 2.4.0

data/lib/anthropic/models/organization/analytics_plugin_activity.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginActivity < Anthropic::Internal::Type::BaseModel
+        # @!attribute claude_code_metrics
+        #   Claude Code activity metrics for a single plugin on a given day.
+        #
+        #   @return [Anthropic::Models::Organization::AnalyticsPluginClaudeCodeMetrics]
+        required :claude_code_metrics, -> { Anthropic::Organization::AnalyticsPluginClaudeCodeMetrics }
+
+        # @!attribute cowork_metrics
+        #   Cowork activity metrics for a single plugin on a given day.
+        #
+        #   @return [Anthropic::Models::Organization::AnalyticsPluginCoworkMetrics]
+        required :cowork_metrics, -> { Anthropic::Organization::AnalyticsPluginCoworkMetrics }
+
+        # @!attribute distinct_user_count
+        #   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.
+        #
+        #   @return [Integer]
+        required :distinct_user_count, Integer
+
+        # @!attribute install_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.
+        #
+        #   @return [Integer, nil]
+        required :install_count, Integer, nil?: true
+
+        # @!attribute invocation_count
+        #   Number of plugin invocations on the requested day
+        #
+        #   @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
+        #
+        #   @return [String]
+        required :plugin_name, String
+
+        # @!attribute chat_cowork_unified_metrics
+        #   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.
+        #
+        #   @return [Anthropic::Models::Organization::AnalyticsPluginChatCoworkUnifiedMetrics, nil]
+        optional :chat_cowork_unified_metrics,
+                 -> { Anthropic::Organization::AnalyticsPluginChatCoworkUnifiedMetrics },
+                 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
+
+        # @!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(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`
+        #   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.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Organization::AnalyticsPluginActivity} for more details.
+        #
+        #   @param claude_code_metrics [Anthropic::Models::Organization::AnalyticsPluginClaudeCodeMetrics] Claude Code activity metrics for a single plugin on a given day.
+        #
+        #   @param cowork_metrics [Anthropic::Models::Organization::AnalyticsPluginCoworkMetrics] Cowork activity metrics for a single plugin on a given day.
+        #
+        #   @param distinct_user_count [Integer] Number of distinct users with recorded install or invocation activity for the pl
+        #
+        #   @param install_count [Integer, nil] Number of distinct users who installed the plugin on the requested day, or, in d
+        #
+        #   @param invocation_count [Integer] Number of plugin invocations on the requested day
+        #
+        #   @param plugin_id [String, nil] Stable plugin identifier when available (e.g. `serena@claude-plugins-official`).
+        #
+        #   @param plugin_name [String] Name of the plugin
+        #
+        #   @param chat_cowork_unified_metrics [Anthropic::Models::Organization::AnalyticsPluginChatCoworkUnifiedMetrics, 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
+        #
+        #   @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
+        #
+        #   @param user_id [String, nil] Tagged user identifier (e.g. `user_...`). Present only when the request grouped
+      end
+    end
+  end
+end

data/lib/anthropic/models/organization/analytics_plugin_chat_cowork_unified_metrics.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginChatCoworkUnifiedMetrics < 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::Organization::AnalyticsPluginChatCoworkUnifiedMetrics} 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/organization/analytics_plugin_claude_code_metrics.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginClaudeCodeMetrics < Anthropic::Internal::Type::BaseModel
+        # @!attribute distinct_session_plugin_used_count
+        #   Number of distinct Claude Code sessions in which the plugin was invoked. 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:)
+        #   Claude Code activity metrics for a single plugin on a given day.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Organization::AnalyticsPluginClaudeCodeMetrics} for more
+        #   details.
+        #
+        #   @param distinct_session_plugin_used_count [Integer, nil] Number of distinct Claude Code sessions in which the plugin was invoked. Null on
+      end
+    end
+  end
+end

data/lib/anthropic/models/organization/analytics_plugin_cowork_metrics.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsPluginCoworkMetrics < Anthropic::Internal::Type::BaseModel
+        # @!attribute distinct_session_plugin_used_count
+        #   Number of distinct Cowork sessions in which the plugin was invoked. 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:)
+        #   Cowork activity metrics for a single plugin on a given day.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Organization::AnalyticsPluginCoworkMetrics} for more
+        #   details.
+        #
+        #   @param distinct_session_plugin_used_count [Integer, nil] Number of distinct Cowork sessions in which the plugin was invoked. Null on aggr
+      end
+    end
+  end
+end

data/lib/anthropic/models/organization/analytics_plugin_group_by.rb

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

data/lib/anthropic/models/organization/analytics_project_activity.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsProjectActivity < 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::Organization::AnalyticsUser, nil]
+        required :created_by, -> { Anthropic::Organization::AnalyticsUser }, 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
+        #   count over the window's per-member daily rows, never a sum of per-day values.
+        #
+        #   @return [Integer]
+        required :distinct_user_count, Integer
+
+        # @!attribute message_count
+        #   Number of messages sent in the project on the requested day
+        #
+        #   @return [Integer]
+        required :message_count, Integer
+
+        # @!attribute project_id
+        #   Tagged project identifier (e.g. `claude_proj_...`)
+        #
+        #   @return [String]
+        required :project_id, String
+
+        # @!attribute project_name
+        #   Name of the project
+        #
+        #   @return [String]
+        required :project_name, String
+
+        # @!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
+
+        # @!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(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::Organization::AnalyticsProjectActivity} 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::Organization::AnalyticsUser, 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
+        #
+        #   @param project_id [String] Tagged project identifier (e.g. `claude_proj_...`)
+        #
+        #   @param project_name [String] Name of the project
+        #
+        #   @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
+        #
+        #   @param user_id [String, nil] Tagged user identifier (e.g. `user_...`). Present only when the request grouped
+      end
+    end
+  end
+end

data/lib/anthropic/models/organization/analytics_project_group_by.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      # A dimension to group chat project activity by.
+      module AnalyticsProjectGroupBy
+        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

data/lib/anthropic/models/organization/analytics_science_metrics.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsScienceMetrics < Anthropic::Internal::Type::BaseModel
+        # @!attribute delegation_count
+        #   Number of delegations (handoffs to a specialized agent) in Claude Science
+        #   sessions
+        #
+        #   @return [Integer]
+        required :delegation_count, Integer
+
+        # @!attribute distinct_session_count
+        #   Number of distinct Claude Science sessions. 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_session_count, Integer, nil?: true
+
+        # @!attribute message_count
+        #   Number of messages sent in Claude Science sessions
+        #
+        #   @return [Integer]
+        required :message_count, Integer
+
+        # @!attribute remote_compute_job_count
+        #   Number of remote compute jobs launched from Claude Science sessions
+        #
+        #   @return [Integer]
+        required :remote_compute_job_count, Integer
+
+        # @!attribute skills_used_count
+        #   Total number of skill invocations in Claude Science sessions
+        #
+        #   @return [Integer]
+        required :skills_used_count, Integer
+
+        # @!method initialize(delegation_count:, distinct_session_count:, message_count:, remote_compute_job_count:, skills_used_count:)
+        #   Claude Science activity metrics for a single user on a given day.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Organization::AnalyticsScienceMetrics} for more details.
+        #
+        #   @param delegation_count [Integer] Number of delegations (handoffs to a specialized agent) in Claude Science sessio
+        #
+        #   @param distinct_session_count [Integer, nil] Number of distinct Claude Science sessions. Approximate (HLL, typical error <2%)
+        #
+        #   @param message_count [Integer] Number of messages sent in Claude Science sessions
+        #
+        #   @param remote_compute_job_count [Integer] Number of remote compute jobs launched from Claude Science sessions
+        #
+        #   @param skills_used_count [Integer] Total number of skill invocations in Claude Science sessions
+      end
+    end
+  end
+end