@thinkai/tai-api-contract 2.106.0 → 2.108.0

package/src/generated/openapi.ts

@@ -1431,6 +1431,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/connectors-snapshot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace connectors snapshot for settings UI
+         * @description Returns workspace config plus GitHub App and GitHub Actions integration status in one response (lighter than separate config and integration status calls).
+         */
+        get: operations["getWorkspaceConnectorsSnapshot"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/github": {
         parameters: {
             query?: never;
@@ -3307,6 +3327,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/me/app-shell": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * App chrome bootstrap payload
+         * @description Returns the authenticated user's profile, workspace list, and preferences in one response. When `workspaceId` is provided and resolves to a workspace the caller belongs to, also returns platform banner, unread notification count, journey progress, and connectors snapshot. Invalid, unknown, or non-member `workspaceId` values do not produce 403/404 — the response is still 200 with only `me`, `workspaces`, and `preferences` (workspace-scoped fields omitted).
+         */
+        get: operations["getAppShell"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/org-chart/import": {
         parameters: {
             query?: never;
@@ -3347,6 +3387,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/your-ai-journey/dashboard-secondary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Secondary dashboard panels bootstrap payload
+         * @description Returns readiness aggregate, merged PR trends (8-week default window), aggregated teams (8-week default window), and agentic foundation dashboard in one response. Nested payloads reuse the same builders and caches as their dedicated routes.
+         */
+        get: operations["getYourAiJourneyDashboardSecondary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/your-ai-journey/analytics": {
         parameters: {
             query?: never;
@@ -7096,6 +7156,30 @@ export interface components {
             analytics: components["schemas"]["YourAiJourneyAnalyticsDto"];
             productivity: components["schemas"]["DashboardProductivityDto"];
         };
+        ConnectorsSnapshotDto: {
+            config: components["schemas"]["WorkspaceConfigDto"];
+            github: components["schemas"]["GithubInstallationStatusDto"];
+            githubActions: components["schemas"]["GithubActionsIntegrationStatusDto"];
+        };
+        AppShellDto: {
+            me: components["schemas"]["MeProfileDto"];
+            workspaces: components["schemas"]["WorkspaceSummaryDto"][];
+            preferences: components["schemas"]["PreferencesDto"];
+            banner?: components["schemas"]["PlatformBannerViewDto"];
+            unreadCount?: components["schemas"]["NotificationUnreadCountDto"];
+            journeyProgress?: components["schemas"]["JourneyProgressDto"];
+            connectorsSnapshot?: components["schemas"]["ConnectorsSnapshotDto"];
+        };
+        DashboardSecondaryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            readinessAggregate: components["schemas"]["YourAiJourneyReadinessAggregateDto"];
+            mergedPrTrends: components["schemas"]["ProductivityInsightsMergedPrTrendsDto"];
+            aggregatedTeams: components["schemas"]["ProductivityInsightsAggregatedTeamsDto"];
+            agenticFoundation: components["schemas"]["AgenticFoundationDashboardDto"];
+        };
         YourAiJourneyAnalyticsDto: {
             /** Format: uuid */
             workspaceId: string;
@@ -7137,6 +7221,8 @@ export interface components {
             /** @description GitHub merged PRs in this week bucket still awaiting ship-weight scoring. */
             shipWeightPendingCount?: number;
             tokenCount: number;
+            /** @description AI tool spend attributed to this week bucket (USD cents). */
+            spendCents?: number;
         };
         YourAiJourneyAiSpendDto: {
             /** Format: uuid */
@@ -7655,6 +7741,11 @@ export interface components {
         InsightsRecommendationsReviewPipelineResponse: components["schemas"]["InsightsRecommendationsReviewPipeline"] & {
             _meta: components["schemas"]["InsightsResponseMeta"];
         };
+        InsightsCostPerPrModelSlice: {
+            modelName: string;
+            spendUsd: number;
+            tokenCount: number;
+        };
         InsightsCostPerPrTeam: {
             id: string;
             name: string;
@@ -7665,6 +7756,8 @@ export interface components {
             changePct: number;
             /** @description Weekly cost per merged PR aligned to the selected week buckets (same order as filters.weekBuckets). Null when the team had no merged PRs in that week. */
             trendUsdPerPr?: (number | null)[];
+            /** @description Model spend mix for teams in the top five by spend in this response (server-computed from AI-tool usage). When multiple providers are in scope, each team's mix reflects that team's dominant provider by spend. Omitted when unavailable. */
+            models?: components["schemas"]["InsightsCostPerPrModelSlice"][];
         };
         InsightsRecommendationsCostPerPr: {
             orgAvgCostUsd: number;
@@ -8754,6 +8847,9 @@ export type YourAiJourneyPrSignalsDto = components['schemas']['YourAiJourneyPrSi
 export type YourAiJourneyReadinessDimensionDto = components['schemas']['YourAiJourneyReadinessDimensionDto'];
 export type YourAiJourneyReadinessAggregateDto = components['schemas']['YourAiJourneyReadinessAggregateDto'];
 export type YourAiJourneyHeroDto = components['schemas']['YourAiJourneyHeroDto'];
+export type ConnectorsSnapshotDto = components['schemas']['ConnectorsSnapshotDto'];
+export type AppShellDto = components['schemas']['AppShellDto'];
+export type DashboardSecondaryDto = components['schemas']['DashboardSecondaryDto'];
 export type YourAiJourneyAnalyticsDto = components['schemas']['YourAiJourneyAnalyticsDto'];
 export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAiSpendWeekDto'];
 export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
@@ -8812,6 +8908,7 @@ export type InsightsReviewStage = components['schemas']['InsightsReviewStage'];
 export type InsightsReviewerLoadItem = components['schemas']['InsightsReviewerLoadItem'];
 export type InsightsRecommendationsReviewPipeline = components['schemas']['InsightsRecommendationsReviewPipeline'];
 export type InsightsRecommendationsReviewPipelineResponse = components['schemas']['InsightsRecommendationsReviewPipelineResponse'];
+export type InsightsCostPerPrModelSlice = components['schemas']['InsightsCostPerPrModelSlice'];
 export type InsightsCostPerPrTeam = components['schemas']['InsightsCostPerPrTeam'];
 export type InsightsRecommendationsCostPerPr = components['schemas']['InsightsRecommendationsCostPerPr'];
 export type InsightsRecommendationsCostPerPrResponse = components['schemas']['InsightsRecommendationsCostPerPrResponse'];
@@ -12915,6 +13012,39 @@ export interface operations {
             };
         };
     };
+    getWorkspaceConnectorsSnapshot: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Connectors snapshot */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConnectorsSnapshotDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getWorkspaceGithubInstallationStatus: {
         parameters: {
             query?: {
@@ -17474,6 +17604,30 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    getAppShell: {
+        parameters: {
+            query?: {
+                /** @description Optional workspace scope for banner, notifications, journey, and connectors. Omitted or unresolvable values yield the base shell without workspace extras. */
+                workspaceId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description App shell bootstrap payload. Workspace-scoped fields (`banner`, `unreadCount`, `journeyProgress`, `connectorsSnapshot`) appear only when `workspaceId` resolves to a workspace the caller belongs to. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AppShellDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     postOrgChartImport: {
         parameters: {
             query?: never;
@@ -17571,6 +17725,39 @@ export interface operations {
             };
         };
     };
+    getYourAiJourneyDashboardSecondary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Secondary dashboard bootstrap payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DashboardSecondaryDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getYourAiJourneyAnalytics: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -3,7 +3,18 @@
  * The ONLY package the frontend may import.
  */
 
-import type { AgenticFoundationDashboardDto } from "./generated/openapi.js";
+import type {
+  AgenticFoundationDashboardDto,
+  GithubActionsIntegrationStatusDto,
+  GithubInstallationStatusDto,
+  JourneyProgressDto,
+  MeProfileDto,
+  NotificationUnreadCountDto,
+  PlatformBannerViewDto,
+  PreferencesDto,
+  WorkspaceConfigDto as OpenApiWorkspaceConfigDto,
+  WorkspaceSummaryDto,
+} from "./generated/openapi.js";
 
 /** Run metadata (window, ruleset, created). M5.4: optional tenantId, personId. */
 export interface RunMetadataDto {
@@ -1191,6 +1202,34 @@ export interface YourAiJourneyHeroDto {
   productivity: YourAiJourneyProductivityDto;
 }
 
+/** GitHub + workspace config snapshot for connectors UI (BFF). */
+export interface ConnectorsSnapshotDto {
+  config: OpenApiWorkspaceConfigDto;
+  github: GithubInstallationStatusDto;
+  githubActions: GithubActionsIntegrationStatusDto;
+}
+
+/** Response for GET /me/app-shell — bootstrap payload for app chrome. */
+export interface AppShellDto {
+  me: MeProfileDto;
+  workspaces: WorkspaceSummaryDto[];
+  preferences: PreferencesDto;
+  banner?: PlatformBannerViewDto;
+  unreadCount?: NotificationUnreadCountDto;
+  journeyProgress?: JourneyProgressDto;
+  connectorsSnapshot?: ConnectorsSnapshotDto;
+}
+
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/dashboard-secondary. */
+export interface DashboardSecondaryDto {
+  workspaceId: string;
+  generatedAt: string;
+  readinessAggregate: YourAiJourneyReadinessAggregateDto;
+  mergedPrTrends: ProductivityInsightsMergedPrTrendsDto;
+  aggregatedTeams: ProductivityInsightsAggregatedTeamsDto;
+  agenticFoundation: AgenticFoundationDashboardDto;
+}
+
 /** Response for GET /workspaces/:workspaceId/your-ai-journey/agentic-foundation — same shape as AgenticFoundationDashboardDto. */
 export type YourAiJourneyAgenticFoundationDto = AgenticFoundationDashboardDto;
 
@@ -1201,6 +1240,7 @@ export interface YourAiJourneyAiSpendWeekDto {
   weekLabel: string;
   mergedPrCount: number;
   tokenCount: number;
+  spendCents?: number;
 }
 
 /** Response for GET /workspaces/:workspaceId/your-ai-journey/ai-spend */
@@ -1661,6 +1701,12 @@ export interface InsightsRecommendationsReviewPipeline {
   reviewerLoad: InsightsReviewerLoadItem[];
 }
 
+export interface InsightsCostPerPrModelSlice {
+  modelName: string;
+  spendUsd: number;
+  tokenCount: number;
+}
+
 export interface InsightsCostPerPrTeam {
   id: string;
   name: string;
@@ -1671,6 +1717,8 @@ export interface InsightsCostPerPrTeam {
   changePct: number;
   /** Weekly $/merged PR for weeks with at least one merged PR in scope. */
   trendUsdPerPr?: (number | null)[];
+  /** Model spend mix for top-spend teams (server-computed). */
+  models?: InsightsCostPerPrModelSlice[];
 }
 
 export interface InsightsRecommendationsCostPerPr {