@thinkai/tai-api-contract 2.5.1 → 2.5.16

package/dist/generated/openapi.d.ts

@@ -227,6 +227,266 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/productivity-insights/aggregated-teams": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Productivity insights — aggregated team weekly metrics
+         * @description Team-level rollup for Productivity insights (Aggregated Teams view on /phase-c/c4). Returns weekly merged PR counts and fail rates per engineering team, filtered by the same department, team, and range controls as the Measure UI.
+         */
+        get: operations["getProductivityInsightsAggregatedTeams"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/productivity-insights/merged-pr-trends": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Productivity insights — merged PR trends (portfolio + contributors)
+         * @description Weekly merged PR counts for the Measure "Merged PR Trends" widget on /phase-c/c4 Individual Contributors. Returns a portfolio aggregate series plus per-contributor weekly counts, filtered by the same department, team, and range controls as the Measure UI.
+         */
+        get: operations["getProductivityInsightsMergedPrTrends"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/productivity-insights/teams": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Productivity insights — top teams and team drilldown
+         * @description Without `teamId`: returns the top-ranked teams by average weekly merged PR count for the Measure **Top teams** widget on /phase-c/c4 and /phase-c/c7. With `teamId`: returns weekly rollup and summary for a single team (powers `/phase-c/c4/teams/:teamId` drilldown).
+         */
+        get: operations["getProductivityInsightsTeams"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/productivity-insights/contributors/{contributorId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Productivity insights — contributor drilldown
+         * @description Weekly and daily activity rollups for a single contributor on `/phase-c/c4/contributors/:id`. Distributes weekly merged PR counts from precomputed person metrics across weekdays; includes fail-rate signals and period-over-period summary deltas. Uses org-chart person ids (typically email).
+         */
+        get: operations["getProductivityInsightsContributor"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/productivity-insights/needs-attention": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Productivity insights — needs attention (bottom performers)
+         * @description Bottom performers for the Measure "Needs attention" widget on /phase-c/c4 (LeadersLaggards laggards column). Returns the lowest-ranked teams or contributors by average weekly merged PR count for the selected filters and range.
+         */
+        get: operations["getProductivityInsightsNeedsAttention"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/aggregated-teams": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — aggregated team weekly rollups
+         * @description Team-level AI adoption, token volume, and spend for the Measure **Aggregated Teams** view on `/phase-c/c7` and the dashboard AI Usage & Spend card. Aggregates stored AI-tool integration snapshots (daily usage + billing spend) by org-chart team using member email. Same filter params as other Measure insights routes.
+         */
+        get: operations["getAiUsageSpendAggregatedTeams"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/aggregated-contributors": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — aggregated contributor weekly rollups
+         * @description Per-contributor AI adoption, token volume, and spend for the Measure **Individual Contributors** view on `/phase-c/c7`. Aggregates stored AI-tool integration snapshots (daily usage + billing spend) by org-chart person id (typically email). Same filter params as other Measure insights routes.
+         */
+        get: operations["getAiUsageSpendAggregatedContributors"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/contributor-tool-heatmap": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — contributor × week heatmap rows
+         * @description Contributor × week heatmap rows for the Measure **Individual Contributors** tool heatmap on `/phase-c/c7`. Same aggregation as aggregated-contributors; returns weekly token, spend, and active-user counts per org-chart person.
+         */
+        get: operations["getAiUsageSpendContributorToolHeatmap"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/key-insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — key insights panel
+         * @description Narrative insight cards for the Measure **Key insights** panel on `/phase-c/c7` (AI Usage & Spend). Derived from scoped AI-tool usage/spend snapshots and productivity metrics for the selected filters and range.
+         */
+        get: operations["getAiUsageSpendKeyInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/ai-assisted-code-percentage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 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.
+         */
+        get: operations["getAiUsageSpendAiAssistedCodePercentage"];
+        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;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — AI tool usage and spend by provider/model
+         * @description Scoped portfolio rollups of AI-tool token usage and spend by registered provider and by model (from daily usage `mostUsedModel`) for the **Provider / Model usage + spend** chart on `/phase-c/c4` and `/phase-c/c7`. Reads stored AI-tool integration snapshots (`tai_workspace_ai_tool_daily_usage`, `tai_workspace_ai_tool_spend`).
+         */
+        get: operations["getAiUsageSpendAiToolUsageSpend"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/team-tool-heatmap": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — team weekly heatmap
+         * @description Team × week rollups of AI-tool token volume, spend, and active users for the **Team tool heatmap** on `/phase-c/c4` and `/phase-c/c7`. Aggregates stored AI-tool integration snapshots by org-chart team. Same filter params as other Measure insights routes.
+         */
+        get: operations["getAiUsageSpendTeamToolHeatmap"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/roi-productivity-signal": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — ROI and productivity signal
+         * @description Connects scoped AI-tool usage and spend to engineering throughput (merged PRs) for the **ROI & Productivity Signal** panel on `/phase-c/c4` and `/phase-c/c7`. Returns spend efficiency metrics, adoption counts, and weekly usage vs PR series. Same filter params as other Measure insights routes.
+         */
+        get: operations["getAiUsageSpendRoiProductivitySignal"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/company-profile": {
         parameters: {
             query?: never;
@@ -1053,7 +1313,7 @@ export interface paths {
         put?: never;
         /**
          * Import org chart from Supabase storage path
-         * @description Parse-only. Downloads the CSV at `storagePath` from the `org-charts` bucket and returns `persons` and `errors`. Does not persist to `spa_org_chart` or `org_chart`. The SPA derives teams client-side and saves the org structure via `POST /workspaces/{workspaceId}/org-chart`.
+         * @description Parse-only. Downloads the CSV at `storagePath` from the `org-charts` bucket and returns `persons` and `errors`. Does not persist to `spa_org_chart` or `org_chart`. The SPA derives teams client-side and saves the org structure via `POST /workspaces/{workspaceId}/org-chart`. Required columns: employee_id, name, email, title, department, team, manager_id, location. Optional: github_username (GitHub login for productivity ingest). Saving the SPA snapshot also materializes a scoring `org_chart` tree for team/person metrics when import members are present.
          */
         post: operations["postOrgChartImport"];
         delete?: never;
@@ -1118,14 +1378,22 @@ export interface components {
             root: components["schemas"]["OrgChartNodeDto"];
         };
         OrgChartPersonDto: {
+            /** @description Stable HR identifier; referenced by manager_id for reporting lines. */
             employeeId: string;
             name: string;
+            /** @description Work email; used as canonical person_id in productivity ingest when present. */
             email: string;
+            /** @description Job title; used for contributor rows and leadership (enabler) hints. */
             title: string;
+            /** @description Department filter on Productivity insights. */
             department: string;
+            /** @description Engineering team name for Aggregated Teams and team drill-downs. */
             team: string;
+            /** @description employee_id of the person's manager; leave empty for top-level leaders. */
             managerId: string;
             location: string;
+            /** @description GitHub login (no @) to map merged PRs and reviews to this person in productivity ingest. */
+            githubUsername?: string;
         };
         OrgChartImportResultDto: {
             persons: components["schemas"]["OrgChartPersonDto"][];
@@ -1249,36 +1517,414 @@ export interface components {
                 metrics: components["schemas"]["DashboardProductivityMetricsDto"];
             }[];
         };
-        MeProfileDto: {
-            id: string;
-            email: string;
-            name: string;
-            roles: string[];
-            defaultWorkspaceId?: string | null;
-        };
-        UpdateMeBodyDto: {
-            name?: string;
-            email?: string;
-            defaultWorkspaceId?: string | null;
+        ProductivityInsightsAggregatedTeamsScopeDto: {
+            /** @description Applied department filter from the Measure UI. Backend scopes via CSV import (`thinkai_org_structure`) or SPA `department` nodes; unknown departments yield empty scoped results rather than org-wide rollups. */
+            department: string;
+            /** @description Applied team name filter from the Measure UI. */
+            team: string;
         };
-        WorkspaceSummaryDto: {
-            id: string;
-            slug: string;
-            name: string;
-            status: string;
+        ProductivityInsightsAggregatedTeamWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            /** @description Short label for the week column (MM/DD), aligned with Measure charts. */
+            weekLabel?: string;
+            mergedPrCount: number;
+            failRatePercent: number;
+        };
+        ProductivityInsightsAggregatedTeamRowDto: {
+            teamId: string;
+            teamName: string;
+            headcount: number;
+            managerLabel?: string;
+            weeks: components["schemas"]["ProductivityInsightsAggregatedTeamWeekDto"][];
+        };
+        ProductivityInsightsAggregatedTeamsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            teams: components["schemas"]["ProductivityInsightsAggregatedTeamRowDto"][];
         };
-        WorkspacesForUserDto: {
-            workspaces: components["schemas"]["WorkspaceSummaryDto"][];
+        ProductivityInsightsMergedPrTrendWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            /** @description Short label for the week column (MM/DD), aligned with Measure charts. */
+            weekLabel?: string;
+            mergedPrCount: number;
+        };
+        ProductivityInsightsMergedPrContributorRowDto: {
+            /** @description Canonical person identifier (matches org chart person_id / employeeId). */
+            personId: string;
+            personName: string;
+            teamName?: string;
+            weeks: components["schemas"]["ProductivityInsightsMergedPrTrendWeekDto"][];
+        };
+        ProductivityInsightsMergedPrTrendsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            /** @description Portfolio aggregate merged PR counts (sum of filtered contributors per week). */
+            weeks: components["schemas"]["ProductivityInsightsMergedPrTrendWeekDto"][];
+            contributors: components["schemas"]["ProductivityInsightsMergedPrContributorRowDto"][];
+        };
+        ProductivityInsightsTeamLeaderItemDto: {
+            /** @description 1-based rank within the top-teams list (1 = highest performer). */
+            rank: number;
+            teamId: string;
+            teamName: string;
+            /** @description Optional context line (e.g. headcount or manager). */
+            subtitle?: string;
+            /** @description Average weekly merged PR count over the selected range. */
+            periodAvgMergedPrs: number;
+            /** @description Percent change of the latest week vs the period average. */
+            deltaVsPeriodAvgPercent: number;
+            /** @description Average change failure rate over the range when available. */
+            avgFailRatePercent?: number;
+        };
+        ProductivityInsightsTeamSummaryDto: {
+            totalMergedPrs: number;
+            avgMergedPrsPerWeek: number;
+            avgFailRatePercent: number;
+            headcount: number;
+        };
+        ProductivityInsightsTeamDetailDto: {
+            teamId: string;
+            teamName: string;
+            headcount: number;
+            managerLabel?: string;
+            weeks: components["schemas"]["ProductivityInsightsAggregatedTeamWeekDto"][];
+            summary: components["schemas"]["ProductivityInsightsTeamSummaryDto"];
+        };
+        ProductivityInsightsTeamsResponseDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            /** @description Present when `teamId` query is omitted — top-ranked teams. */
+            items?: components["schemas"]["ProductivityInsightsTeamLeaderItemDto"][];
+            /** @description Present when `teamId` query is set — single-team drilldown. */
+            team?: components["schemas"]["ProductivityInsightsTeamDetailDto"];
         };
-        CreateWorkspaceBodyDto: {
-            slug: string;
+        ProductivityInsightsContributorProfileDto: {
+            /** @description Org-chart person id (typically email). */
+            id: string;
             name: string;
+            title?: string;
+            team?: string;
+            department?: string;
         };
-        CompanyProfileDto: {
-            companyName: string;
-            industry: string;
-            industryOther?: string;
-            /** @description One of 1-50 | 51-200 | 201-500 | 501-1000 | 1000+ */
+        ProductivityInsightsContributorActivityDayDto: {
+            /** Format: date */
+            date: string;
+            dayIndex: number;
+            mergedPrCount: number;
+            mergedPrs: string[];
+            absent: boolean;
+            absenceType?: string;
+            failureSignal: boolean;
+            failures: string[];
+        };
+        ProductivityInsightsContributorActivityWeekDto: {
+            label: string;
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            days: components["schemas"]["ProductivityInsightsContributorActivityDayDto"][];
+        };
+        ProductivityInsightsContributorActivitySummaryDto: {
+            totalMergedPrs: number;
+            avgMergedPrsPerWeek: number;
+            totalAbsenceDays: number;
+            avgFailRate: number;
+            mergedPrDelta: number;
+            avgMergedPrsPerWeekDelta: number;
+            totalAbsenceDaysDelta: number;
+            avgFailRateDelta: number;
+        };
+        ProductivityInsightsContributorDetailDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            contributorId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            contributor: components["schemas"]["ProductivityInsightsContributorProfileDto"];
+            weeks: components["schemas"]["ProductivityInsightsContributorActivityWeekDto"][];
+            summary: components["schemas"]["ProductivityInsightsContributorActivitySummaryDto"];
+        };
+        ProductivityInsightsNeedsAttentionItemDto: {
+            /** @description 1-based rank within the laggards list (1 = lowest performer). */
+            rank: number;
+            /** @description Org chart team id or canonical person id. */
+            entityId: string;
+            /** @enum {string} */
+            entityType: "team" | "contributor";
+            name: string;
+            /** @description Optional context line (e.g. headcount or job title). */
+            subtitle?: string;
+            /** @description Mean weekly merged PR count across the selected range. */
+            periodAvgMergedPrs: number;
+            /** @description Percent change of the latest week vs the period mean. */
+            deltaVsPeriodAvgPercent: number;
+            /** @description Mean weekly change-failure rate when available. */
+            avgFailRatePercent?: number;
+        };
+        ProductivityInsightsNeedsAttentionDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** @enum {string} */
+            entityType: "teams" | "contributors";
+            /** Format: date-time */
+            generatedAt: string;
+            items: components["schemas"]["ProductivityInsightsNeedsAttentionItemDto"][];
+        };
+        AiUsageSpendAggregatedTeamWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            /** @description Short label for table headers (e.g. MM/DD). */
+            weekLabel?: string;
+            /** @description Total tokens consumed in the bucket (from AI-tool daily usage payloads when available). */
+            tokenCount: number;
+            /** @description Estimated spend in USD cents attributed to the bucket. */
+            spendCents: number;
+            /** @description Distinct engineers with active AI-tool usage in the bucket. */
+            activeUsers: number;
+        };
+        AiUsageSpendAggregatedTeamRowDto: {
+            teamId: string;
+            teamName: string;
+            headcount: number;
+            managerLabel?: string;
+            weeks: components["schemas"]["AiUsageSpendAggregatedTeamWeekDto"][];
+        };
+        AiUsageSpendAggregatedTeamsSummaryDto: {
+            totalTokenCount: number;
+            totalSpendCents: number;
+            /** @description Distinct engineers with any active usage in the selected range. */
+            activeUsers: number;
+            /** @description Count of connected AI-tool providers with usage or spend in range. */
+            activeTools: number;
+            /** @description Sum of org-chart headcount across returned teams. */
+            totalEngineers: number;
+        };
+        AiUsageSpendAggregatedTeamsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            teams: components["schemas"]["AiUsageSpendAggregatedTeamRowDto"][];
+            summary: components["schemas"]["AiUsageSpendAggregatedTeamsSummaryDto"];
+        };
+        AiUsageSpendAggregatedContributorRowDto: {
+            /** @description Org-chart person id (typically email). */
+            contributorId: string;
+            contributorName: string;
+            title?: string;
+            team?: string;
+            department?: string;
+            weeks: components["schemas"]["AiUsageSpendAggregatedTeamWeekDto"][];
+        };
+        AiUsageSpendAggregatedContributorsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            contributors: components["schemas"]["AiUsageSpendAggregatedContributorRowDto"][];
+            summary: components["schemas"]["AiUsageSpendAggregatedTeamsSummaryDto"];
+        };
+        AiUsageSpendContributorToolHeatmapDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            contributors: components["schemas"]["AiUsageSpendAggregatedContributorRowDto"][];
+        };
+        AiUsageSpendKeyInsightItemDto: {
+            /** @description Stable insight key (e.g. spend-leader, spend-vs-output). */
+            id: string;
+            /** @enum {string} */
+            tone: "positive" | "warning" | "neutral";
+            /** @description Human-readable insight sentence for the UI panel. */
+            text: string;
+        };
+        AiUsageSpendKeyInsightsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            items: components["schemas"]["AiUsageSpendKeyInsightItemDto"][];
+        };
+        /**
+         * @description **measured** — derived from scoped productivity ingest (`aiAdoption.aiAssistedContributionRatioPercent`). **estimated** — derived from AI-tool token volume heuristics when ingest ratios are absent for that bucket.
+         * @enum {string}
+         */
+        AiAssistedCodeDataQuality: "estimated" | "measured";
+        AiUsageSpendAiAssistedCodeWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            weekLabel?: string;
+            aiAssistedCodePercent: number;
+            totalLoc: number;
+            aiLoc: number;
+            humanLoc: number;
+            dataQuality: components["schemas"]["AiAssistedCodeDataQuality"];
+        };
+        AiUsageSpendAiAssistedCodePercentageDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            /** @description Portfolio AI-assisted code share for the selected period (0–100). */
+            aiAssistedCodePercent: number;
+            /** @description Period rollup quality. **measured** only when every weekly bucket in `weeks` used ingest ratios; otherwise **estimated** (including mixed ingest/heuristic weeks). */
+            dataQuality: components["schemas"]["AiAssistedCodeDataQuality"];
+            /** @description Change in AI-assisted code share vs the prior half of the range (percentage points). */
+            deltaVsPriorPeriodPercent: number;
+            totalLoc: number;
+            aiLoc: number;
+            humanLoc: number;
+            /** @default 50 */
+            targetMinPercent: number;
+            /** @default 75 */
+            targetMaxPercent: number;
+            weeks: components["schemas"]["AiUsageSpendAiAssistedCodeWeekDto"][];
+        };
+        AiUsageSpendAiToolUsageSpendProviderItemDto: {
+            providerId: string;
+            providerName: string;
+            tokenCount: number;
+            spendCents: number;
+            activeUsers: number;
+        };
+        AiUsageSpendAiToolUsageSpendModelItemDto: {
+            providerId: string;
+            providerName: string;
+            modelName: string;
+            tokenCount: number;
+            spendCents: number;
+        };
+        AiUsageSpendAiToolUsageSpendDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            totalEngineers: number;
+            providers: components["schemas"]["AiUsageSpendAiToolUsageSpendProviderItemDto"][];
+            models: components["schemas"]["AiUsageSpendAiToolUsageSpendModelItemDto"][];
+        };
+        AiUsageSpendTeamToolHeatmapDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            teams: components["schemas"]["AiUsageSpendAggregatedTeamRowDto"][];
+        };
+        AiUsageSpendRoiProductivitySignalWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            weekLabel?: string;
+            /** @description Estimated merged PR count in the bucket from dashboard velocity metrics. */
+            mergedPrCount: number;
+            /** @description Total AI-tool tokens consumed in the bucket. */
+            tokenCount: number;
+        };
+        AiUsageSpendRoiProductivitySignalDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            totalMergedPrs: number;
+            totalSpendCents: number;
+            activeUsers: number;
+            totalEngineers: number;
+            /** @description Share of merged PRs estimated to be AI-assisted (0–1). */
+            aiAssistedPrRatio: number;
+            /** @description Percent change in merged PR throughput (recent half vs prior half of range). */
+            prThroughputDeltaPercent: number;
+            /** @description Percent change in token usage (recent half vs prior half of range). */
+            usageDeltaPercent: number;
+            weeks: components["schemas"]["AiUsageSpendRoiProductivitySignalWeekDto"][];
+        };
+        MeProfileDto: {
+            id: string;
+            email: string;
+            name: string;
+            roles: string[];
+            defaultWorkspaceId?: string | null;
+        };
+        UpdateMeBodyDto: {
+            name?: string;
+            email?: string;
+            defaultWorkspaceId?: string | null;
+        };
+        WorkspaceSummaryDto: {
+            id: string;
+            slug: string;
+            name: string;
+            status: string;
+        };
+        WorkspacesForUserDto: {
+            workspaces: components["schemas"]["WorkspaceSummaryDto"][];
+        };
+        CreateWorkspaceBodyDto: {
+            slug: string;
+            name: string;
+        };
+        CompanyProfileDto: {
+            companyName: string;
+            industry: string;
+            industryOther?: string;
+            /** @description One of 1-50 | 51-200 | 201-500 | 501-1000 | 1000+ */
             companySize: string;
             engineeringHC: string;
             headquarters: string;
@@ -1299,6 +1945,17 @@ export interface components {
             language?: string | null;
             private?: boolean | null;
         };
+        GithubMissingPermissionDto: {
+            /** @description GitHub App permission key (e.g. contents, pull_requests). */
+            name: string;
+            /** @enum {string} */
+            required: "read" | "write" | "admin";
+            /**
+             * @description Null when the installation has not granted this permission.
+             * @enum {string|null}
+             */
+            granted?: "read" | "write" | "admin" | null;
+        };
         GithubInstallationSummaryDto: {
             installationId: string;
             account: components["schemas"]["GithubAccountDto"];
@@ -1307,10 +1964,17 @@ export interface components {
             manageUrl?: string | null;
             /** Format: date-time */
             lastSyncedAt?: string | null;
+            /** @description True when this installation's granted permissions are below what the ThinkAI GitHub App currently requests. */
+            permissionsUpgradeRequired: boolean;
+            missingPermissions?: components["schemas"]["GithubMissingPermissionDto"][];
+            /** @description Human-readable summary for UI when permissionsUpgradeRequired is true. */
+            upgradeMessage?: string | null;
         };
         GithubInstallationStatusDto: {
             installed: boolean;
             installations: components["schemas"]["GithubInstallationSummaryDto"][];
+            /** @description True if any connected installation is under-permissioned. */
+            permissionsUpgradeRequired: boolean;
             installationId?: string | null;
             account?: components["schemas"]["GithubAccountDto"] | null;
             repos?: components["schemas"]["GithubInstalledRepoDto"][] | null;
@@ -1785,6 +2449,8 @@ export interface components {
         ProjectId: string;
         NotificationId: string;
         FixId: string;
+        /** @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). */
+        InsightsDepartmentFilter: string;
     };
     requestBodies: never;
     headers: never;
@@ -1814,6 +2480,42 @@ export type AiToolRefreshResponseDto = components['schemas']['AiToolRefreshRespo
 export type DashboardProductivityMetricsDto = components['schemas']['DashboardProductivityMetricsDto'];
 export type DashboardProductivityDto = components['schemas']['DashboardProductivityDto'];
 export type DashboardProductivityHistoryDto = components['schemas']['DashboardProductivityHistoryDto'];
+export type ProductivityInsightsAggregatedTeamsScopeDto = components['schemas']['ProductivityInsightsAggregatedTeamsScopeDto'];
+export type ProductivityInsightsAggregatedTeamWeekDto = components['schemas']['ProductivityInsightsAggregatedTeamWeekDto'];
+export type ProductivityInsightsAggregatedTeamRowDto = components['schemas']['ProductivityInsightsAggregatedTeamRowDto'];
+export type ProductivityInsightsAggregatedTeamsDto = components['schemas']['ProductivityInsightsAggregatedTeamsDto'];
+export type ProductivityInsightsMergedPrTrendWeekDto = components['schemas']['ProductivityInsightsMergedPrTrendWeekDto'];
+export type ProductivityInsightsMergedPrContributorRowDto = components['schemas']['ProductivityInsightsMergedPrContributorRowDto'];
+export type ProductivityInsightsMergedPrTrendsDto = components['schemas']['ProductivityInsightsMergedPrTrendsDto'];
+export type ProductivityInsightsTeamLeaderItemDto = components['schemas']['ProductivityInsightsTeamLeaderItemDto'];
+export type ProductivityInsightsTeamSummaryDto = components['schemas']['ProductivityInsightsTeamSummaryDto'];
+export type ProductivityInsightsTeamDetailDto = components['schemas']['ProductivityInsightsTeamDetailDto'];
+export type ProductivityInsightsTeamsResponseDto = components['schemas']['ProductivityInsightsTeamsResponseDto'];
+export type ProductivityInsightsContributorProfileDto = components['schemas']['ProductivityInsightsContributorProfileDto'];
+export type ProductivityInsightsContributorActivityDayDto = components['schemas']['ProductivityInsightsContributorActivityDayDto'];
+export type ProductivityInsightsContributorActivityWeekDto = components['schemas']['ProductivityInsightsContributorActivityWeekDto'];
+export type ProductivityInsightsContributorActivitySummaryDto = components['schemas']['ProductivityInsightsContributorActivitySummaryDto'];
+export type ProductivityInsightsContributorDetailDto = components['schemas']['ProductivityInsightsContributorDetailDto'];
+export type ProductivityInsightsNeedsAttentionItemDto = components['schemas']['ProductivityInsightsNeedsAttentionItemDto'];
+export type ProductivityInsightsNeedsAttentionDto = components['schemas']['ProductivityInsightsNeedsAttentionDto'];
+export type AiUsageSpendAggregatedTeamWeekDto = components['schemas']['AiUsageSpendAggregatedTeamWeekDto'];
+export type AiUsageSpendAggregatedTeamRowDto = components['schemas']['AiUsageSpendAggregatedTeamRowDto'];
+export type AiUsageSpendAggregatedTeamsSummaryDto = components['schemas']['AiUsageSpendAggregatedTeamsSummaryDto'];
+export type AiUsageSpendAggregatedTeamsDto = components['schemas']['AiUsageSpendAggregatedTeamsDto'];
+export type AiUsageSpendAggregatedContributorRowDto = components['schemas']['AiUsageSpendAggregatedContributorRowDto'];
+export type AiUsageSpendAggregatedContributorsDto = components['schemas']['AiUsageSpendAggregatedContributorsDto'];
+export type AiUsageSpendContributorToolHeatmapDto = components['schemas']['AiUsageSpendContributorToolHeatmapDto'];
+export type AiUsageSpendKeyInsightItemDto = components['schemas']['AiUsageSpendKeyInsightItemDto'];
+export type AiUsageSpendKeyInsightsDto = components['schemas']['AiUsageSpendKeyInsightsDto'];
+export type AiAssistedCodeDataQuality = components['schemas']['AiAssistedCodeDataQuality'];
+export type AiUsageSpendAiAssistedCodeWeekDto = components['schemas']['AiUsageSpendAiAssistedCodeWeekDto'];
+export type AiUsageSpendAiAssistedCodePercentageDto = components['schemas']['AiUsageSpendAiAssistedCodePercentageDto'];
+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 AiUsageSpendRoiProductivitySignalWeekDto = components['schemas']['AiUsageSpendRoiProductivitySignalWeekDto'];
+export type AiUsageSpendRoiProductivitySignalDto = components['schemas']['AiUsageSpendRoiProductivitySignalDto'];
 export type MeProfileDto = components['schemas']['MeProfileDto'];
 export type UpdateMeBodyDto = components['schemas']['UpdateMeBodyDto'];
 export type WorkspaceSummaryDto = components['schemas']['WorkspaceSummaryDto'];
@@ -1822,6 +2524,7 @@ export type CreateWorkspaceBodyDto = components['schemas']['CreateWorkspaceBodyD
 export type CompanyProfileDto = components['schemas']['CompanyProfileDto'];
 export type GithubAccountDto = components['schemas']['GithubAccountDto'];
 export type GithubInstalledRepoDto = components['schemas']['GithubInstalledRepoDto'];
+export type GithubMissingPermissionDto = components['schemas']['GithubMissingPermissionDto'];
 export type GithubInstallationSummaryDto = components['schemas']['GithubInstallationSummaryDto'];
 export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
 export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
@@ -1886,6 +2589,7 @@ export type ParameterRepoId = components['parameters']['RepoId'];
 export type ParameterProjectId = components['parameters']['ProjectId'];
 export type ParameterNotificationId = components['parameters']['NotificationId'];
 export type ParameterFixId = components['parameters']['FixId'];
+export type ParameterInsightsDepartmentFilter = components['parameters']['InsightsDepartmentFilter'];
 export type $defs = Record<string, never>;
 export interface operations {
     getMe: {
@@ -2401,6 +3105,692 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    getProductivityInsightsAggregatedTeams: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Aggregated team productivity series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductivityInsightsAggregatedTeamsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getProductivityInsightsMergedPrTrends: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Portfolio and per-contributor merged PR weekly series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductivityInsightsMergedPrTrendsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getProductivityInsightsTeams: {
+        parameters: {
+            query?: {
+                /** @description When set, return drilldown for this org-chart team id instead of the top-team list. */
+                teamId?: string;
+                /** @description Maximum top-team rows when `teamId` is omitted (UI default 3). */
+                limit?: number;
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Top teams list or single-team drilldown */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductivityInsightsTeamsResponseDto"];
+                };
+            };
+            /** @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 or team not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getProductivityInsightsContributor: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Org-chart person id (e.g. email from `person_id` external id). */
+                contributorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Contributor activity drilldown */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductivityInsightsContributorDetailDto"];
+                };
+            };
+            /** @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 or contributor not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getProductivityInsightsNeedsAttention: {
+        parameters: {
+            query?: {
+                /** @description Rank teams (Aggregated Teams tab) or contributors (Individual Contributors tab). */
+                entityType?: "teams" | "contributors";
+                /** @description Maximum number of laggard rows to return (UI default 3). */
+                limit?: number;
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bottom performers for the needs-attention widget */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductivityInsightsNeedsAttentionDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendAggregatedTeams: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Aggregated team AI usage and spend series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendAggregatedTeamsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendAggregatedContributors: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Aggregated contributor AI usage and spend series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendAggregatedContributorsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendContributorToolHeatmap: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Contributor heatmap rows for AI usage and spend */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendContributorToolHeatmapDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendKeyInsights: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Key insight cards for the AI usage & spend panel */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendKeyInsightsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendAiAssistedCodePercentage: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description AI-assisted code percentage series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendAiAssistedCodePercentageDto"];
+                };
+            };
+            /** @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 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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Provider and model AI tool usage/spend rollups */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendAiToolUsageSpendDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendTeamToolHeatmap: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Team weekly AI usage heatmap rows */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendTeamToolHeatmapDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
+    getAiUsageSpendRoiProductivitySignal: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @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;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description ROI and productivity signal rollups */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendRoiProductivitySignalDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
     getCompanyProfile: {
         parameters: {
             query?: never;
@@ -2492,6 +3882,8 @@ export interface operations {
             query?: {
                 /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub. */
                 refresh?: boolean;
+                /** @description When true, re-fetch GitHub App and installation permission metadata (used by the login permission gate after the user approves on GitHub). */
+                permissionsRefresh?: boolean;
             };
             header?: never;
             path: {