@thinkai/tai-api-contract 2.50.0-pr.877.6ff333f6 → 2.51.0-pr.877.bf4a3821

package/src/generated/openapi.ts

@@ -3129,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;
@@ -3148,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;
@@ -3163,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;
@@ -3178,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;
@@ -3194,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;
@@ -3212,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;
@@ -3229,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;
@@ -3244,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;
@@ -3267,7 +3350,9 @@ 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";
@@ -3288,8 +3373,18 @@ export interface components {
         AiUsageSpendProviderEngagementInsightsDto: {
             /** 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;
@@ -3312,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;
@@ -3324,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;
@@ -3345,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;
@@ -3360,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;
@@ -3369,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;
@@ -3380,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;
@@ -5246,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'];
@@ -5257,6 +5419,7 @@ 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'];
@@ -5267,9 +5430,12 @@ export type AiUsageSpendAiToolUsageSpendProviderItemDto = components['schemas'][
 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'];
@@ -7308,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. */
@@ -7360,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. */
@@ -7412,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. */
@@ -7464,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. */
@@ -7516,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. */
@@ -7568,14 +7754,24 @@ export interface operations {
     getAiUsageSpendProviderEngagementInsights: {
         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. */
                 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: {
@@ -7620,8 +7816,12 @@ export interface operations {
     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. */
@@ -7672,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. */
@@ -7724,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. */
@@ -7776,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. */