anthropic 1.74.0 → 1.76.0

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

@@ -0,0 +1,216 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorActivity < Anthropic::Internal::Type::BaseModel
+          # @!attribute chat_metrics
+          #   Claude.ai activity metrics for a single connector on a given day.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatMetrics]
+          required :chat_metrics, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorChatMetrics }
+
+          # @!attribute claude_code_metrics
+          #   Claude Code activity metrics for a single connector on a given day.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorClaudeCodeMetrics]
+          required :claude_code_metrics,
+                   -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorClaudeCodeMetrics }
+
+          # @!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.
+          #
+          #   @return [String]
+          required :connector_name, String
+
+          # @!attribute cowork_metrics
+          #   Cowork activity metrics for a single connector on a given day.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorCoworkMetrics]
+          required :cowork_metrics, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorCoworkMetrics }
+
+          # @!attribute distinct_user_count
+          #   Number of distinct users who used the connector 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 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 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.
+          #   Companion bucket to `managed_auth_distinct_user_count`, which carries the
+          #   measurement, attribution, and null rules. Users whose requests used no stored
+          #   credential count in neither bucket.
+          #
+          #   @return [Integer, nil]
+          optional :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
+          #   Enterprise Managed Auth (an organization-managed credential provisioned through
+          #   the organization's identity provider), read from the token record each request
+          #   used. Null, never 0, when managed-auth reporting is not enabled for the
+          #   organization, the value cannot be attributed to the row, no credentialed
+          #   requests and no managed-token mint events (a managed credential being
+          #   provisioned for a user's use of the connector) were observed that day, or the
+          #   day predates 2026-07-01, the first day the backing data exists (forward-only
+          #   data, no backfill). When credentialed requests or mint events were observed and
+          #   attributed, both managed-auth fields populate, reporting 0 for a bucket with no
+          #   users; the two counts are independent, not a partition — a user whose requests
+          #   that day used both kinds of credential counts in both. Mint events carry user
+          #   but not surface attribution, so they count as observed auth activity on
+          #   `user_id` and `rbac_group_id` cuts — attributed to the user the credential was
+          #   provisioned for — but never on a cut that references `product` (group or
+          #   filter). Date-range rollup mode (`starting_date`/`ending_date`) computes both
+          #   fields exactly over the window — distinct users with at least one qualifying day
+          #   — when the whole window starts on or after 2026-07-01, with the null-versus-0
+          #   and mint-event rules applying with the window in place of the day; a range
+          #   starting earlier reports every managed-auth field as null, never a
+          #   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`, or `office_agent` (the canonical Cost & Usage product naming; an
+          #   `office_agent` row's per-surface breakdown is in its `office_metrics`). On
+          #   `/plugins` only `cowork` and `claude_code` occur (the only surfaces with plugin
+          #   attribution); on `/artifacts` only `chat`, `claude_code`, and `cowork` 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 read_call_count
+          #   Number of connector tool calls on the requested day whose trusted read-only
+          #   annotation marked them read-only. Call count, not distinct users. Every call
+          #   recorded on a classified surface lands in exactly one of `read_call_count`,
+          #   `write_call_count`, or `unclassified_call_count`, so the three sum to the day's
+          #   classified calls. Classification is forward-only per surface: claude.ai from
+          #   2026-06-01, Claude Code from 2026-05-30, Claude in Office from 2026-05-29,
+          #   Cowork from 2026-06-02 (Cowork clients predating annotation forwarding land in
+          #   `unclassified_call_count`). Null, never 0, when the value cannot be stated: the
+          #   read/write split is not enabled for this organization, or the day predates
+          #   2026-05-29. For a date-range total, sum the per-day values, but treat a window
+          #   that extends before 2026-05-29 as null rather than summing only its covered days
+          #   — date-range rollup mode (`starting_date`/`ending_date`) applies both rules
+          #   server-side.
+          #
+          #   @return [Integer, nil]
+          optional :read_call_count, Integer, nil?: true
+
+          # @!attribute unclassified_call_count
+          #   Number of connector tool calls on the requested day with no trusted read-only
+          #   annotation — the annotation is optional in the MCP spec and is discarded when
+          #   connector access controls are active, so unclassified calls are common. This
+          #   field shows how much of the day's classified activity the read/write split
+          #   actually covers. Call count, not distinct users. One of the three
+          #   call-classification buckets; see `read_call_count` for the per-surface
+          #   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
+
+          # @!attribute write_call_count
+          #   Number of connector tool calls on the requested day whose trusted read-only
+          #   annotation marked them not read-only. Call count, not distinct users. One of the
+          #   three call-classification buckets; see `read_call_count` for the per-surface
+          #   data-start dates, null conditions, and date-range guidance.
+          #
+          #   @return [Integer, nil]
+          optional :write_call_count, Integer, nil?: true
+
+          # @!method initialize(chat_metrics:, claude_code_metrics:, connector_name:, cowork_metrics:, distinct_user_count:, office_metrics:, 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)
+          #   Per-connector activity data for a given day.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorActivity} for more
+          #   details.
+          #
+          #   @param chat_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatMetrics] Claude.ai activity metrics for a single connector on a given day.
+          #
+          #   @param claude_code_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorClaudeCodeMetrics] Claude Code activity metrics for a single connector on a given day.
+          #
+          #   @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 office_metrics [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics] Office Agent activity metrics for a single connector on a given day, broken out
+          #
+          #   @param connector_display_name [String, nil] Human-readable display name for rows whose `connector_name` is an opaque connect
+          #
+          #   @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 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 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
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorChatMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute distinct_conversation_connector_used_count
+          #   Number of distinct conversations in which the connector was used. 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_conversation_connector_used_count, Integer, nil?: true
+
+          # @!method initialize(distinct_conversation_connector_used_count:)
+          #   Claude.ai activity metrics for a single connector on a given day.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorChatMetrics} for
+          #   more details.
+          #
+          #   @param distinct_conversation_connector_used_count [Integer, nil] Number of distinct conversations in which the connector was used. Approximate (H
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorClaudeCodeMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute distinct_session_connector_used_count
+          #   Number of distinct Claude Code sessions in which the connector was used.
+          #   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_connector_used_count, Integer, nil?: true
+
+          # @!method initialize(distinct_session_connector_used_count:)
+          #   Claude Code activity metrics for a single connector on a given day.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorClaudeCodeMetrics}
+          #   for more details.
+          #
+          #   @param distinct_session_connector_used_count [Integer, nil] Number of distinct Claude Code sessions in which the connector was used. Approxi
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorCoworkMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute distinct_session_connector_used_count
+          #   Number of distinct Cowork sessions in which the connector was used. 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_connector_used_count, Integer, nil?: true
+
+          # @!method initialize(distinct_session_connector_used_count:)
+          #   Cowork activity metrics for a single connector on a given day.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorCoworkMetrics} for
+          #   more details.
+          #
+          #   @param distinct_session_connector_used_count [Integer, nil] Number of distinct Cowork sessions in which the connector was used. Approximate
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorOfficeMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute excel
+          #   Office Agent activity metrics for a single connector on a given day within one
+          #   Office product.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics]
+          required :excel, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics }
+
+          # @!attribute outlook
+          #   Office Agent activity metrics for a single connector on a given day within one
+          #   Office product.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics]
+          required :outlook, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics }
+
+          # @!attribute powerpoint
+          #   Office Agent activity metrics for a single connector on a given day within one
+          #   Office product.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics]
+          required :powerpoint, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics }
+
+          # @!attribute word
+          #   Office Agent activity metrics for a single connector on a given day within one
+          #   Office product.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics]
+          required :word, -> { Anthropic::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics }
+
+          # @!method initialize(excel:, outlook:, powerpoint:, word:)
+          #   Office Agent activity metrics for a single connector on a given day, broken out
+          #   by Office product.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeMetrics} for
+          #   more details.
+          #
+          #   @param excel [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics] Office Agent activity metrics for a single connector on a given day within one O
+          #
+          #   @param outlook [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics] Office Agent activity metrics for a single connector on a given day within one O
+          #
+          #   @param powerpoint [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics] Office Agent activity metrics for a single connector on a given day within one O
+          #
+          #   @param word [Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics] Office Agent activity metrics for a single connector on a given day within one O
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsConnectorOfficeProductMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute distinct_session_connector_used_count
+          #   Number of distinct Office Agent sessions in which the connector was used.
+          #   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_connector_used_count, Integer, nil?: true
+
+          # @!method initialize(distinct_session_connector_used_count:)
+          #   Office Agent activity metrics for a single connector on a given day within one
+          #   Office product.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsConnectorOfficeProductMetrics}
+          #   for more details.
+          #
+          #   @param distinct_session_connector_used_count [Integer, nil] Number of distinct Office Agent sessions in which the connector was used. Approx
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsContextWindow
+          extend Anthropic::Internal::Type::Enum
+
+          FROM_0_TO_200K = :"0-200k"
+          FROM_200K_TO_1_M = :"200k-1M"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsCoreCodeMetrics < Anthropic::Internal::Type::BaseModel
+          # @!attribute artifacts_created_count
+          #   Number of artifacts created in Claude Code sessions: an artifact counts once, on
+          #   the day a session first saves it. Counted from 2026-08-17; 0 on earlier days.
+          #   Exact in date-range mode: a creation belongs to exactly one day, so the per-day
+          #   counts never overlap and their sum over the window is the exact count of
+          #   distinct creations in it.
+          #
+          #   @return [Integer]
+          required :artifacts_created_count, Integer
+
+          # @!attribute commit_count
+          #   Number of commits made via Claude Code
+          #
+          #   @return [Integer]
+          required :commit_count, Integer
+
+          # @!attribute distinct_session_count
+          #   Number of distinct Claude Code sessions. On aggregated rows and in date-range
+          #   mode: summed per-day distinct counts. A session essentially never spans a UTC
+          #   day, so the sum is in practice the true distinct count.
+          #
+          #   @return [Integer, nil]
+          required :distinct_session_count, Integer, nil?: true
+
+          # @!attribute lines_of_code
+          #   Lines of code added and removed via Claude Code.
+          #
+          #   @return [Anthropic::Models::Beta::Organization::BetaAnalyticsLinesOfCode]
+          required :lines_of_code, -> { Anthropic::Beta::Organization::BetaAnalyticsLinesOfCode }
+
+          # @!attribute pull_request_count
+          #   Number of pull requests created via Claude Code
+          #
+          #   @return [Integer]
+          required :pull_request_count, Integer
+
+          # @!method initialize(artifacts_created_count:, commit_count:, distinct_session_count:, lines_of_code:, pull_request_count:)
+          #   Core Claude Code activity metrics for a single user on a given day.
+          #
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsCoreCodeMetrics} for more
+          #   details.
+          #
+          #   @param artifacts_created_count [Integer] Number of artifacts created in Claude Code sessions: an artifact counts once, on
+          #
+          #   @param commit_count [Integer] Number of commits made via Claude Code
+          #
+          #   @param distinct_session_count [Integer, nil] Number of distinct Claude Code sessions. On aggregated rows and in date-range mo
+          #
+          #   @param lines_of_code [Anthropic::Models::Beta::Organization::BetaAnalyticsLinesOfCode] Lines of code added and removed via Claude Code.
+          #
+          #   @param pull_request_count [Integer] Number of pull requests created via Claude Code
+        end
+      end
+    end
+  end
+end