@thinkai/tai-api-contract 2.5.2 → 2.5.17

package/src/generated/openapi.ts

@@ -69,7 +69,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List workspace team members */
+        /**
+         * List workspace team members
+         * @description Returns active workspace members (`tai_workspace_members` with `deleted_at` null). Any workspace member may list; invite and role changes require admin.
+         */
         get: operations["listTenantMembers"];
         put?: never;
         post?: never;
@@ -88,7 +91,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Invite member to workspace */
+        /**
+         * Invite member to workspace
+         * @description Workspace admin only. Upserts `tai_users` by email and adds or reactivates `tai_workspace_members`. Idempotent when the email is already an active member: returns **201** with the existing row and **does not change** their role if the request body role differs. Does not send email; optional `tai_workspace_invitations` row may be recorded (no accept/link flow yet).
+         */
         post: operations["inviteTenantMember"];
         delete?: never;
         options?: never;
@@ -106,11 +112,17 @@ export interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /** Remove member from workspace */
+        /**
+         * Remove member from workspace
+         * @description Workspace admin only. Soft-deletes the membership (`deleted_at` set). Cannot remove the workspace owner or the last admin.
+         */
         delete: operations["removeTenantMember"];
         options?: never;
         head?: never;
-        /** Update workspace member role */
+        /**
+         * Update workspace member role
+         * @description Workspace admin only. `memberId` is `tai_users.id` (UUID), not the auth subject.
+         */
         patch: operations["updateTenantMemberRole"];
         trace?: never;
     };
@@ -228,6 +240,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;
@@ -1054,7 +1326,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;
@@ -1069,8 +1341,11 @@ export interface components {
     schemas: {
         ErrorMessageDto: {
             error: string;
+            /** @description Machine-readable error code when present (for example `last_admin`). */
+            code?: string;
         };
         TeamMemberDto: {
+            /** Format: uuid */
             id: string;
             name: string;
             email: string;
@@ -1119,14 +1394,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"][];
@@ -1250,26 +1533,404 @@ export interface components {
                 metrics: components["schemas"]["DashboardProductivityMetricsDto"];
             }[];
         };
-        MeProfileDto: {
-            id: string;
-            email: string;
-            name: string;
-            roles: 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;
         };
-        UpdateMeBodyDto: {
-            name?: string;
-            email?: string;
-            defaultWorkspaceId?: string | null;
+        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"][];
         };
-        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"];
+        };
+        ProductivityInsightsContributorProfileDto: {
+            /** @description Org-chart person id (typically email). */
             id: string;
-            slug: string;
             name: string;
-            status: string;
-        };
-        WorkspacesForUserDto: {
-            workspaces: components["schemas"]["WorkspaceSummaryDto"][];
+            title?: string;
+            team?: string;
+            department?: string;
+        };
+        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;
@@ -1803,7 +2464,11 @@ export interface components {
         RepoId: string;
         ProjectId: string;
         NotificationId: string;
+        /** @description Workspace member user id (`tai_users.id`). */
+        WorkspaceMemberId: 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;
@@ -1833,6 +2498,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'];
@@ -1905,7 +2606,9 @@ export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
 export type ParameterRepoId = components['parameters']['RepoId'];
 export type ParameterProjectId = components['parameters']['ProjectId'];
 export type ParameterNotificationId = components['parameters']['NotificationId'];
+export type ParameterWorkspaceMemberId = components['parameters']['WorkspaceMemberId'];
 export type ParameterFixId = components['parameters']['FixId'];
+export type ParameterInsightsDepartmentFilter = components['parameters']['InsightsDepartmentFilter'];
 export type $defs = Record<string, never>;
 export interface operations {
     getMe: {
@@ -2033,11 +2736,32 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "members": [
+                     *         {
+                     *           "id": "11111111-1111-4111-8111-111111111111",
+                     *           "name": "Alex Admin",
+                     *           "email": "alex@example.com",
+                     *           "role": "admin"
+                     *         }
+                     *       ]
+                     *     }
+                     */
                     "application/json": components["schemas"]["TeamMemberListDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     inviteTenantMember: {
@@ -2051,6 +2775,12 @@ export interface operations {
         };
         requestBody: {
             content: {
+                /**
+                 * @example {
+                 *       "email": "new.member@example.com",
+                 *       "role": "editor"
+                 *     }
+                 */
                 "application/json": components["schemas"]["InviteTeamMemberBodyDto"];
             };
         };
@@ -2064,8 +2794,26 @@ export interface operations {
                     "application/json": components["schemas"]["TeamMemberDto"];
                 };
             };
+            /** @description Invalid email or role */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     removeTenantMember: {
@@ -2074,7 +2822,8 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                memberId: string;
+                /** @description Workspace member user id (`tai_users.id`). */
+                memberId: components["parameters"]["WorkspaceMemberId"];
             };
             cookie?: never;
         };
@@ -2089,12 +2838,23 @@ export interface operations {
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Member not found */
+            /** @description Member not found or invalid memberId */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Cannot remove workspace owner or last admin */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
             };
         };
     };
@@ -2104,12 +2864,18 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                memberId: string;
+                /** @description Workspace member user id (`tai_users.id`). */
+                memberId: components["parameters"]["WorkspaceMemberId"];
             };
             cookie?: never;
         };
         requestBody: {
             content: {
+                /**
+                 * @example {
+                 *       "role": "viewer"
+                 *     }
+                 */
                 "application/json": components["schemas"]["UpdateTeamMemberRoleBodyDto"];
             };
         };
@@ -2123,14 +2889,34 @@ export interface operations {
                     "application/json": components["schemas"]["TeamMemberDto"];
                 };
             };
+            /** @description Invalid role payload */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Member not found */
+            /** @description Member not found or invalid memberId */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Cannot demote the last workspace admin */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
             };
         };
     };
@@ -2421,6 +3207,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;