anthropic 2.2.0 → 2.4.0

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

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

@@ -0,0 +1,321 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Organization
+      class AnalyticsSingleDayActivitySummary < Anthropic::Internal::Type::BaseModel
+        # @!attribute assigned_seat_count
+        #   Number of seats currently assigned to members. Null when the response is scoped
+        #   to an RBAC group — seat assignment is org-wide and has no per-group analogue.
+        #
+        #   @return [Integer, nil]
+        required :assigned_seat_count, Integer, nil?: true
+
+        # @!attribute cowork_daily_active_user_count
+        #   Number of users with Cowork activity on the requested day
+        #
+        #   @return [Integer]
+        required :cowork_daily_active_user_count, Integer
+
+        # @!attribute cowork_monthly_active_user_count
+        #   Number of users with Cowork activity in the 30-day rolling window
+        #
+        #   @return [Integer]
+        required :cowork_monthly_active_user_count, Integer
+
+        # @!attribute cowork_weekly_active_user_count
+        #   Number of users with Cowork activity in the 7-day rolling window
+        #
+        #   @return [Integer]
+        required :cowork_weekly_active_user_count, Integer
+
+        # @!attribute daily_active_user_count
+        #   Number of users with token consumption on the requested day
+        #
+        #   @return [Integer]
+        required :daily_active_user_count, Integer
+
+        # @!attribute daily_adoption_rate
+        #   Percentage of assigned seats with activity on the requested day
+        #   (`DAU / assigned_seat_count * 100`). Null when the response is scoped to an RBAC
+        #   group.
+        #
+        #   @return [Float, nil]
+        required :daily_adoption_rate, Float, nil?: true
+
+        # @!attribute ending_at
+        #   End of the aggregation period (exclusive), UTC midnight in RFC 3339 format (e.g.
+        #   `2026-01-16T00:00:00Z`).
+        #
+        #   @return [Time]
+        required :ending_at, Time
+
+        # @!attribute monthly_active_user_count
+        #   Number of users with token consumption in the 30-day rolling window
+        #
+        #   @return [Integer]
+        required :monthly_active_user_count, Integer
+
+        # @!attribute monthly_adoption_rate
+        #   Percentage of assigned seats with activity in the 30-day rolling window
+        #   (`MAU / assigned_seat_count * 100`). Null when the response is scoped to an RBAC
+        #   group.
+        #
+        #   @return [Float, nil]
+        required :monthly_adoption_rate, Float, nil?: true
+
+        # @!attribute pending_invite_count
+        #   Number of pending invitations to join the organization. Null when the response
+        #   is scoped to an RBAC group.
+        #
+        #   @return [Integer, nil]
+        required :pending_invite_count, Integer, nil?: true
+
+        # @!attribute starting_at
+        #   Start of the aggregation period (inclusive), UTC midnight in RFC 3339 format
+        #   (e.g. `2026-01-15T00:00:00Z`).
+        #
+        #   @return [Time]
+        required :starting_at, Time
+
+        # @!attribute weekly_active_user_count
+        #   Number of users with token consumption in the 7-day rolling window
+        #
+        #   @return [Integer]
+        required :weekly_active_user_count, Integer
+
+        # @!attribute weekly_adoption_rate
+        #   Percentage of assigned seats with activity in the 7-day rolling window
+        #   (`WAU / assigned_seat_count * 100`). Null when the response is scoped to an RBAC
+        #   group.
+        #
+        #   @return [Float, nil]
+        required :weekly_adoption_rate, Float, nil?: true
+
+        # @!attribute chat_cowork_unified_daily_active_user_count
+        #   Number of users with activity in Chat and Cowork unified on the requested day.
+        #   Omitted from the response on deployments that do not offer Chat and Cowork
+        #   unified.
+        #
+        #   @return [Integer, nil]
+        optional :chat_cowork_unified_daily_active_user_count, Integer, nil?: true
+
+        # @!attribute chat_cowork_unified_monthly_active_user_count
+        #   Number of users with activity in Chat and Cowork unified in the 28-day rolling
+        #   window (30 days when the request filters by `rbac_group_id`). Omitted from the
+        #   response on deployments that do not offer Chat and Cowork unified.
+        #
+        #   @return [Integer, nil]
+        optional :chat_cowork_unified_monthly_active_user_count, Integer, nil?: true
+
+        # @!attribute chat_cowork_unified_weekly_active_user_count
+        #   Number of users with activity in Chat and Cowork unified in the 7-day rolling
+        #   window. Omitted from the response on deployments that do not offer Chat and
+        #   Cowork unified.
+        #
+        #   @return [Integer, nil]
+        optional :chat_cowork_unified_weekly_active_user_count, Integer, nil?: true
+
+        # @!attribute chat_daily_active_user_count
+        #   Number of users with claude.ai (chat) activity on the requested day. Omitted
+        #   from the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :chat_daily_active_user_count, Integer, nil?: true
+
+        # @!attribute chat_monthly_active_user_count
+        #   Number of users with claude.ai (chat) activity in the 30-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :chat_monthly_active_user_count, Integer, nil?: true
+
+        # @!attribute chat_weekly_active_user_count
+        #   Number of users with claude.ai (chat) activity in the 7-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :chat_weekly_active_user_count, Integer, nil?: true
+
+        # @!attribute claude_code_daily_active_user_count
+        #   Number of users with Claude Code activity on the requested day. Omitted from the
+        #   response while the per-product breakdown is not enabled for this organization.
+        #
+        #   @return [Integer, nil]
+        optional :claude_code_daily_active_user_count, Integer, nil?: true
+
+        # @!attribute claude_code_monthly_active_user_count
+        #   Number of users with Claude Code activity in the 30-day rolling window. Omitted
+        #   from the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :claude_code_monthly_active_user_count, Integer, nil?: true
+
+        # @!attribute claude_code_weekly_active_user_count
+        #   Number of users with Claude Code activity in the 7-day rolling window. Omitted
+        #   from the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :claude_code_weekly_active_user_count, Integer, nil?: true
+
+        # @!attribute claude_design_daily_active_user_count
+        #   Number of users with Claude Design activity on the requested day. Omitted from
+        #   the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :claude_design_daily_active_user_count, Integer, nil?: true
+
+        # @!attribute claude_design_monthly_active_user_count
+        #   Number of users with Claude Design activity in the 30-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :claude_design_monthly_active_user_count, Integer, nil?: true
+
+        # @!attribute claude_design_weekly_active_user_count
+        #   Number of users with Claude Design activity in the 7-day rolling window. Omitted
+        #   from the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :claude_design_weekly_active_user_count, Integer, nil?: true
+
+        # @!attribute office_agent_daily_active_user_count
+        #   Number of users with Claude in Office activity on the requested day. Omitted
+        #   from the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :office_agent_daily_active_user_count, Integer, nil?: true
+
+        # @!attribute office_agent_monthly_active_user_count
+        #   Number of users with Claude in Office activity in the 30-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :office_agent_monthly_active_user_count, Integer, nil?: true
+
+        # @!attribute office_agent_weekly_active_user_count
+        #   Number of users with Claude in Office activity in the 7-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :office_agent_weekly_active_user_count, Integer, nil?: true
+
+        # @!attribute science_daily_active_user_count
+        #   Number of users with Claude Science activity on the requested day. Omitted from
+        #   the response while the per-product breakdown is not enabled for this
+        #   organization.
+        #
+        #   @return [Integer, nil]
+        optional :science_daily_active_user_count, Integer, nil?: true
+
+        # @!attribute science_entitled_user_count
+        #   Number of users with a Claude Science seat entitlement (per-seat RBAC) at the
+        #   time of the daily snapshot. The funnel top; independent of the org-level Claude
+        #   Science toggle. Null when the response is scoped to an RBAC group — entitlement
+        #   is org-wide and has no per-group analogue. Omitted from the response while the
+        #   per-product breakdown is not enabled for this organization.
+        #
+        #   @return [Integer, nil]
+        optional :science_entitled_user_count, Integer, nil?: true
+
+        # @!attribute science_monthly_active_user_count
+        #   Number of users with Claude Science activity in the 30-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :science_monthly_active_user_count, Integer, nil?: true
+
+        # @!attribute science_weekly_active_user_count
+        #   Number of users with Claude Science activity in the 7-day rolling window.
+        #   Omitted from the response while the per-product breakdown is not enabled for
+        #   this organization.
+        #
+        #   @return [Integer, nil]
+        optional :science_weekly_active_user_count, Integer, nil?: true
+
+        # @!method initialize(assigned_seat_count:, cowork_daily_active_user_count:, cowork_monthly_active_user_count:, cowork_weekly_active_user_count:, daily_active_user_count:, daily_adoption_rate:, ending_at:, monthly_active_user_count:, monthly_adoption_rate:, pending_invite_count:, starting_at:, weekly_active_user_count:, weekly_adoption_rate:, chat_cowork_unified_daily_active_user_count: nil, chat_cowork_unified_monthly_active_user_count: nil, chat_cowork_unified_weekly_active_user_count: nil, chat_daily_active_user_count: nil, chat_monthly_active_user_count: nil, chat_weekly_active_user_count: nil, claude_code_daily_active_user_count: nil, claude_code_monthly_active_user_count: nil, claude_code_weekly_active_user_count: nil, claude_design_daily_active_user_count: nil, claude_design_monthly_active_user_count: nil, claude_design_weekly_active_user_count: nil, office_agent_daily_active_user_count: nil, office_agent_monthly_active_user_count: nil, office_agent_weekly_active_user_count: nil, science_daily_active_user_count: nil, science_entitled_user_count: nil, science_monthly_active_user_count: nil, science_weekly_active_user_count: nil)
+        #   Per-day entry in the /summaries response.
+        #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Organization::AnalyticsSingleDayActivitySummary} for more
+        #   details.
+        #
+        #   @param assigned_seat_count [Integer, nil] Number of seats currently assigned to members. Null when the response is scoped
+        #
+        #   @param cowork_daily_active_user_count [Integer] Number of users with Cowork activity on the requested day
+        #
+        #   @param cowork_monthly_active_user_count [Integer] Number of users with Cowork activity in the 30-day rolling window
+        #
+        #   @param cowork_weekly_active_user_count [Integer] Number of users with Cowork activity in the 7-day rolling window
+        #
+        #   @param daily_active_user_count [Integer] Number of users with token consumption on the requested day
+        #
+        #   @param daily_adoption_rate [Float, nil] Percentage of assigned seats with activity on the requested day (`DAU / assigned
+        #
+        #   @param ending_at [Time] End of the aggregation period (exclusive), UTC midnight in RFC 3339 format (e.g.
+        #
+        #   @param monthly_active_user_count [Integer] Number of users with token consumption in the 30-day rolling window
+        #
+        #   @param monthly_adoption_rate [Float, nil] Percentage of assigned seats with activity in the 30-day rolling window (`MAU /
+        #
+        #   @param pending_invite_count [Integer, nil] Number of pending invitations to join the organization. Null when the response i
+        #
+        #   @param starting_at [Time] Start of the aggregation period (inclusive), UTC midnight in RFC 3339 format (e.
+        #
+        #   @param weekly_active_user_count [Integer] Number of users with token consumption in the 7-day rolling window
+        #
+        #   @param weekly_adoption_rate [Float, nil] Percentage of assigned seats with activity in the 7-day rolling window (`WAU / a
+        #
+        #   @param chat_cowork_unified_daily_active_user_count [Integer, nil] Number of users with activity in Chat and Cowork unified on the requested day. O
+        #
+        #   @param chat_cowork_unified_monthly_active_user_count [Integer, nil] Number of users with activity in Chat and Cowork unified in the 28-day rolling w
+        #
+        #   @param chat_cowork_unified_weekly_active_user_count [Integer, nil] Number of users with activity in Chat and Cowork unified in the 7-day rolling wi
+        #
+        #   @param chat_daily_active_user_count [Integer, nil] Number of users with claude.ai (chat) activity on the requested day. Omitted fro
+        #
+        #   @param chat_monthly_active_user_count [Integer, nil] Number of users with claude.ai (chat) activity in the 30-day rolling window. Omi
+        #
+        #   @param chat_weekly_active_user_count [Integer, nil] Number of users with claude.ai (chat) activity in the 7-day rolling window. Omit
+        #
+        #   @param claude_code_daily_active_user_count [Integer, nil] Number of users with Claude Code activity on the requested day. Omitted from the
+        #
+        #   @param claude_code_monthly_active_user_count [Integer, nil] Number of users with Claude Code activity in the 30-day rolling window. Omitted
+        #
+        #   @param claude_code_weekly_active_user_count [Integer, nil] Number of users with Claude Code activity in the 7-day rolling window. Omitted f
+        #
+        #   @param claude_design_daily_active_user_count [Integer, nil] Number of users with Claude Design activity on the requested day. Omitted from t
+        #
+        #   @param claude_design_monthly_active_user_count [Integer, nil] Number of users with Claude Design activity in the 30-day rolling window. Omitte
+        #
+        #   @param claude_design_weekly_active_user_count [Integer, nil] Number of users with Claude Design activity in the 7-day rolling window. Omitted
+        #
+        #   @param office_agent_daily_active_user_count [Integer, nil] Number of users with Claude in Office activity on the requested day. Omitted fro
+        #
+        #   @param office_agent_monthly_active_user_count [Integer, nil] Number of users with Claude in Office activity in the 30-day rolling window. Omi
+        #
+        #   @param office_agent_weekly_active_user_count [Integer, nil] Number of users with Claude in Office activity in the 7-day rolling window. Omit
+        #
+        #   @param science_daily_active_user_count [Integer, nil] Number of users with Claude Science activity on the requested day. Omitted from
+        #
+        #   @param science_entitled_user_count [Integer, nil] Number of users with a Claude Science seat entitlement (per-seat RBAC) at the ti
+        #
+        #   @param science_monthly_active_user_count [Integer, nil] Number of users with Claude Science activity in the 30-day rolling window. Omitt
+        #
+        #   @param science_weekly_active_user_count [Integer, nil] Number of users with Claude Science activity in the 7-day rolling window. Omitte
+      end
+    end
+  end
+end