@thinkai/tai-api-contract 2.49.0 → 2.51.0-pr.877.bf4a3821

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.49.0",
+  "version": "2.51.0-pr.877.bf4a3821",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -748,7 +748,7 @@ export interface paths {
         };
         /**
          * AI usage & spend insights — AI-assisted code percentage
-         * @description Period and weekly AI-assisted code percentage for the Measure **AI-assisted code** card on `/phase-c/c7` and the **AI impact** curve on `/phase-c/c4`. When scoped productivity metrics include `aiAssistedContributionRatioPercent`, values are **measured** from ingest; otherwise the API falls back to token→LOC heuristics and sets `dataQuality` to **estimated**. Clients should not present estimated series as Cursor-measured signal.
+         * @description Period and weekly AI-assisted code percentage for the Measure **AI-assisted code** card on `/phase-c/c7` and the **AI impact** curve on `/phase-c/c4`. When engagement daily rows exist for the scope, values are **measured** from Σ `ai_lines_added` ÷ merged-PR lines (`dashboard_metrics`); otherwise the API falls back to token→LOC heuristics and sets `dataQuality` to **estimated**. Clients should not present estimated series as editor-measured signal.
          */
         get: operations["getAiUsageSpendAiAssistedCodePercentage"];
         put?: never;
@@ -759,6 +759,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/provider-engagement-insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — provider engagement cards
+         * @description Provider-specific engagement insight metrics derived from `tai_workspace_ai_tool_engagement_daily` (accepted AI lines, tab completions, suggestion accept rates, Claude Code sessions, etc.). Metrics are **provider- and data-gated**: structurally absent signals render as N/A, not zero. Claude per-user cards require Enterprise Analytics (`insightsPlan` ≠ team).
+         */
+        get: operations["getAiUsageSpendProviderEngagementInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/insights/ai-usage-spend/ai-tool-usage-spend": {
         parameters: {
             query?: never;
@@ -3109,6 +3129,25 @@ export interface components {
             githubActionsCiEnabled?: boolean;
             items: components["schemas"]["ProductivityInsightsNeedsAttentionItemDto"][];
         };
+        /**
+         * @description Echo of the resolved time bucket for this response. `day` when the request used an `Nd`/`cr:`/`from`+`to` window; `week` for legacy weekly rangeIds.
+         * @enum {string}
+         */
+        AiUsageSpendGranularity: "day" | "week";
+        /** @description Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. */
+        AiUsageSpendRangeId: string;
+        AiUsageSpendDailyBucketDto: {
+            /**
+             * Format: date
+             * @description UTC calendar day (`YYYY-MM-DD`).
+             */
+            date: string;
+            /** @description Short label for table headers (e.g. MM/DD). */
+            dayLabel?: string;
+            tokenCount: number;
+            spendCents: number;
+            activeUsers: number;
+        };
         AiUsageSpendAggregatedTeamWeekDto: {
             /** Format: date-time */
             bucketStart: string;
@@ -3128,7 +3167,9 @@ export interface components {
             teamName: string;
             headcount: number;
             managerLabel?: string;
-            weeks: components["schemas"]["AiUsageSpendAggregatedTeamWeekDto"][];
+            /** @description Present in day-mode responses — daily token, spend, and active-user counts. */
+            days?: components["schemas"]["AiUsageSpendDailyBucketDto"][];
+            weeks?: components["schemas"]["AiUsageSpendAggregatedTeamWeekDto"][];
         };
         AiUsageSpendAggregatedTeamsSummaryDto: {
             totalTokenCount: number;
@@ -3143,8 +3184,18 @@ export interface components {
         AiUsageSpendAggregatedTeamsDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3158,13 +3209,25 @@ export interface components {
             title?: string;
             team?: string;
             department?: string;
-            weeks: components["schemas"]["AiUsageSpendAggregatedTeamWeekDto"][];
+            /** @description Present in day-mode responses — daily token, spend, and active-user counts. */
+            days?: components["schemas"]["AiUsageSpendDailyBucketDto"][];
+            weeks?: components["schemas"]["AiUsageSpendAggregatedTeamWeekDto"][];
         };
         AiUsageSpendAggregatedContributorsDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3174,8 +3237,18 @@ export interface components {
         AiUsageSpendContributorToolHeatmapDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3192,8 +3265,18 @@ export interface components {
         AiUsageSpendKeyInsightsDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3209,6 +3292,16 @@ export interface components {
          * @enum {string}
          */
         AiAssistedCodeEstimationSource: "ingest" | "token_volume" | "spend_proxy" | "adoption" | "unavailable";
+        AiUsageSpendAiAssistedCodeDayDto: {
+            /** Format: date */
+            date: string;
+            dayLabel?: string;
+            aiAssistedCodePercent: number;
+            totalLoc: number;
+            aiLoc: number;
+            humanLoc: number;
+            dataQuality: components["schemas"]["AiAssistedCodeDataQuality"];
+        };
         AiUsageSpendAiAssistedCodeWeekDto: {
             /** Format: date-time */
             bucketStart: string;
@@ -3224,8 +3317,18 @@ export interface components {
         AiUsageSpendAiAssistedCodePercentageDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3247,7 +3350,45 @@ export interface components {
             totalTokenCount?: number;
             /** @description Scoped AI-tool spend in cents for the selected period. */
             totalSpendCents?: number;
-            weeks: components["schemas"]["AiUsageSpendAiAssistedCodeWeekDto"][];
+            /** @description Present in day-mode responses — daily AI-assisted code share series. */
+            days?: components["schemas"]["AiUsageSpendAiAssistedCodeDayDto"][];
+            weeks?: components["schemas"]["AiUsageSpendAiAssistedCodeWeekDto"][];
+        };
+        /** @enum {string} */
+        ProviderEngagementInsightAvailability: "measured" | "not_applicable";
+        AiUsageSpendProviderEngagementMetricDto: {
+            id: string;
+            label: string;
+            value: number | null;
+            displayValue: string;
+            availability: components["schemas"]["ProviderEngagementInsightAvailability"];
+            unit?: string;
+            methodologyNote?: string;
+        };
+        AiUsageSpendProviderEngagementCardDto: {
+            providerId: string;
+            providerName: string;
+            metrics: components["schemas"]["AiUsageSpendProviderEngagementMetricDto"][];
+        };
+        AiUsageSpendProviderEngagementInsightsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            providers: components["schemas"]["AiUsageSpendProviderEngagementCardDto"][];
         };
         AiUsageSpendAiToolUsageSpendProviderItemDto: {
             providerId: string;
@@ -3266,8 +3407,18 @@ export interface components {
         AiUsageSpendAiToolUsageSpendDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3278,13 +3429,30 @@ export interface components {
         AiUsageSpendTeamToolHeatmapDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
             teams: components["schemas"]["AiUsageSpendAggregatedTeamRowDto"][];
         };
+        AiUsageSpendRoiProductivitySignalDayDto: {
+            /** Format: date */
+            date: string;
+            dayLabel?: string;
+            mergedPrCount: number;
+            tokenCount: number;
+        };
         AiUsageSpendRoiProductivitySignalWeekDto: {
             /** Format: date-time */
             bucketStart: string;
@@ -3299,8 +3467,18 @@ export interface components {
         AiUsageSpendRoiProductivitySignalDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
@@ -3314,7 +3492,16 @@ export interface components {
             prThroughputDeltaPercent: number;
             /** @description Percent change in token usage (recent half vs prior half of range). */
             usageDeltaPercent: number;
-            weeks: components["schemas"]["AiUsageSpendRoiProductivitySignalWeekDto"][];
+            /** @description Present in day-mode responses — daily merged PR and token counts. */
+            days?: components["schemas"]["AiUsageSpendRoiProductivitySignalDayDto"][];
+            weeks?: components["schemas"]["AiUsageSpendRoiProductivitySignalWeekDto"][];
+        };
+        AiUsageSpendUsageTrendsProviderDayDto: {
+            providerId: string;
+            providerName: string;
+            spendCents: number;
+            tokenCount: number;
+            activeUsers: number;
         };
         AiUsageSpendUsageTrendsProviderWeekDto: {
             providerId: string;
@@ -3323,6 +3510,12 @@ export interface components {
             tokenCount: number;
             activeUsers: number;
         };
+        AiUsageSpendUsageTrendsDayDto: {
+            /** Format: date */
+            date: string;
+            dayLabel?: string;
+            providers: components["schemas"]["AiUsageSpendUsageTrendsProviderDayDto"][];
+        };
         AiUsageSpendUsageTrendsWeekDto: {
             /** Format: date-time */
             bucketStart: string;
@@ -3334,12 +3527,24 @@ export interface components {
         AiUsageSpendUsageTrendsDto: {
             /** Format: uuid */
             workspaceId: string;
-            /** @enum {string} */
-            range: "4w" | "8w" | "q";
+            range: components["schemas"]["AiUsageSpendRangeId"];
+            granularity?: components["schemas"]["AiUsageSpendGranularity"];
+            /**
+             * Format: date
+             * @description Inclusive start day when `granularity` is `day`.
+             */
+            from?: string;
+            /**
+             * Format: date
+             * @description Inclusive end day when `granularity` is `day`.
+             */
+            to?: string;
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
-            weeks: components["schemas"]["AiUsageSpendUsageTrendsWeekDto"][];
+            /** @description Present in day-mode responses — per-provider spend and usage by day. */
+            days?: components["schemas"]["AiUsageSpendUsageTrendsDayDto"][];
+            weeks?: components["schemas"]["AiUsageSpendUsageTrendsWeekDto"][];
         };
         AiToolMemberSummaryDto: {
             externalId: string;
@@ -5200,6 +5405,9 @@ export type ProductivityInsightsContributorActivitySummaryDto = components['sche
 export type ProductivityInsightsContributorDetailDto = components['schemas']['ProductivityInsightsContributorDetailDto'];
 export type ProductivityInsightsNeedsAttentionItemDto = components['schemas']['ProductivityInsightsNeedsAttentionItemDto'];
 export type ProductivityInsightsNeedsAttentionDto = components['schemas']['ProductivityInsightsNeedsAttentionDto'];
+export type AiUsageSpendGranularity = components['schemas']['AiUsageSpendGranularity'];
+export type AiUsageSpendRangeId = components['schemas']['AiUsageSpendRangeId'];
+export type AiUsageSpendDailyBucketDto = components['schemas']['AiUsageSpendDailyBucketDto'];
 export type AiUsageSpendAggregatedTeamWeekDto = components['schemas']['AiUsageSpendAggregatedTeamWeekDto'];
 export type AiUsageSpendAggregatedTeamRowDto = components['schemas']['AiUsageSpendAggregatedTeamRowDto'];
 export type AiUsageSpendAggregatedTeamsSummaryDto = components['schemas']['AiUsageSpendAggregatedTeamsSummaryDto'];
@@ -5211,15 +5419,23 @@ export type AiUsageSpendKeyInsightItemDto = components['schemas']['AiUsageSpendK
 export type AiUsageSpendKeyInsightsDto = components['schemas']['AiUsageSpendKeyInsightsDto'];
 export type AiAssistedCodeDataQuality = components['schemas']['AiAssistedCodeDataQuality'];
 export type AiAssistedCodeEstimationSource = components['schemas']['AiAssistedCodeEstimationSource'];
+export type AiUsageSpendAiAssistedCodeDayDto = components['schemas']['AiUsageSpendAiAssistedCodeDayDto'];
 export type AiUsageSpendAiAssistedCodeWeekDto = components['schemas']['AiUsageSpendAiAssistedCodeWeekDto'];
 export type AiUsageSpendAiAssistedCodePercentageDto = components['schemas']['AiUsageSpendAiAssistedCodePercentageDto'];
+export type ProviderEngagementInsightAvailability = components['schemas']['ProviderEngagementInsightAvailability'];
+export type AiUsageSpendProviderEngagementMetricDto = components['schemas']['AiUsageSpendProviderEngagementMetricDto'];
+export type AiUsageSpendProviderEngagementCardDto = components['schemas']['AiUsageSpendProviderEngagementCardDto'];
+export type AiUsageSpendProviderEngagementInsightsDto = components['schemas']['AiUsageSpendProviderEngagementInsightsDto'];
 export type AiUsageSpendAiToolUsageSpendProviderItemDto = components['schemas']['AiUsageSpendAiToolUsageSpendProviderItemDto'];
 export type AiUsageSpendAiToolUsageSpendModelItemDto = components['schemas']['AiUsageSpendAiToolUsageSpendModelItemDto'];
 export type AiUsageSpendAiToolUsageSpendDto = components['schemas']['AiUsageSpendAiToolUsageSpendDto'];
 export type AiUsageSpendTeamToolHeatmapDto = components['schemas']['AiUsageSpendTeamToolHeatmapDto'];
+export type AiUsageSpendRoiProductivitySignalDayDto = components['schemas']['AiUsageSpendRoiProductivitySignalDayDto'];
 export type AiUsageSpendRoiProductivitySignalWeekDto = components['schemas']['AiUsageSpendRoiProductivitySignalWeekDto'];
 export type AiUsageSpendRoiProductivitySignalDto = components['schemas']['AiUsageSpendRoiProductivitySignalDto'];
+export type AiUsageSpendUsageTrendsProviderDayDto = components['schemas']['AiUsageSpendUsageTrendsProviderDayDto'];
 export type AiUsageSpendUsageTrendsProviderWeekDto = components['schemas']['AiUsageSpendUsageTrendsProviderWeekDto'];
+export type AiUsageSpendUsageTrendsDayDto = components['schemas']['AiUsageSpendUsageTrendsDayDto'];
 export type AiUsageSpendUsageTrendsWeekDto = components['schemas']['AiUsageSpendUsageTrendsWeekDto'];
 export type AiUsageSpendUsageTrendsDto = components['schemas']['AiUsageSpendUsageTrendsDto'];
 export type AiToolMemberSummaryDto = components['schemas']['AiToolMemberSummaryDto'];
@@ -7258,8 +7474,12 @@ export interface operations {
     getAiUsageSpendAggregatedTeams: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7310,8 +7530,12 @@ export interface operations {
     getAiUsageSpendAggregatedContributors: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7362,8 +7586,12 @@ export interface operations {
     getAiUsageSpendContributorToolHeatmap: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7414,8 +7642,12 @@ export interface operations {
     getAiUsageSpendKeyInsights: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7466,8 +7698,12 @@ export interface operations {
     getAiUsageSpendAiAssistedCodePercentage: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7515,11 +7751,77 @@ export interface operations {
             };
         };
     };
+    getAiUsageSpendProviderEngagementInsights: {
+        parameters: {
+            query?: {
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
+                /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
+                department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description Team name filter; send `All teams` to include every team. */
+                team?: string;
+                /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
+                windowEnd?: string;
+                /** @description When set, aggregate engagement metrics for a single AI-tool member (user detail pages). Mutually exclusive with `scopeTeamId`. */
+                memberExternalId?: string;
+                /** @description Org-chart team id — aggregate engagement for members mapped to that team (team detail pages). Mutually exclusive with `memberExternalId`. */
+                scopeTeamId?: string;
+                /** @description Optional provider id filter (`cursor`, `claude`) for detail pages. */
+                provider?: "cursor" | "claude";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Provider engagement insight cards */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendProviderEngagementInsightsDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getAiUsageSpendAiToolUsageSpend: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7570,8 +7872,12 @@ export interface operations {
     getAiUsageSpendTeamToolHeatmap: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7622,8 +7928,12 @@ export interface operations {
     getAiUsageSpendRoiProductivitySignal: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */
@@ -7674,8 +7984,12 @@ export interface operations {
     getAiUsageSpendUsageTrends: {
         parameters: {
             query?: {
-                /** @description Measure time range (maps to weekly bucket count). */
-                rangeId?: "4w" | "8w" | "q";
+                /** @description Productivity insights time range. Daily windows: `7d`, `30d`, `90d`, `180d`, or custom `cr:YYYY-MM-DD:YYYY-MM-DD`. Weekly legacy: `4w`, `8w`, `q` (12 weeks), `12w`, `16w`. Omit when using explicit `from`/`to` day bounds. */
+                rangeId?: components["parameters"]["InsightsProductivityRangeId"];
+                /** @description Inclusive start of a daily window (`YYYY-MM-DD`). When set with `to`, overrides `rangeId` for day-mode responses (max 180 days). */
+                from?: components["parameters"]["InsightsProductivityFrom"];
+                /** @description Inclusive end of a daily window (`YYYY-MM-DD`). When set with `from`, overrides `rangeId` for day-mode responses (max 180 days). */
+                to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
                 /** @description Team name filter; send `All teams` to include every team. */