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

package/dist/generated/openapi.d.ts

@@ -3128,6 +3128,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;
@@ -3147,7 +3166,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;
@@ -3162,8 +3183,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;
@@ -3177,13 +3208,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;
@@ -3193,8 +3236,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;
@@ -3211,8 +3264,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;
@@ -3228,6 +3291,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;
@@ -3243,8 +3316,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;
@@ -3266,7 +3349,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";
@@ -3287,8 +3372,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;
@@ -3311,8 +3406,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;
@@ -3323,13 +3428,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;
@@ -3344,8 +3466,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;
@@ -3359,7 +3491,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;
@@ -3368,6 +3509,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;
@@ -3379,12 +3526,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;
@@ -5245,6 +5404,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'];
@@ -5256,6 +5418,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'];
@@ -5266,9 +5429,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'];
@@ -7307,8 +7473,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. */
@@ -7359,8 +7529,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. */
@@ -7411,8 +7585,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. */
@@ -7463,8 +7641,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. */
@@ -7515,8 +7697,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. */
@@ -7567,8 +7753,12 @@ 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. */
@@ -7619,8 +7809,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. */
@@ -7671,8 +7865,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. */
@@ -7723,8 +7921,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. */
@@ -7775,8 +7977,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. */