@thinkai/tai-api-contract 2.107.0 → 2.109.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;
@@ -3318,7 +3358,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`. 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.
+         * @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), bitbucket_nickname, bitbucket_uuid, alternate_emails (comma-separated alternate work emails for AI tool spend attribution). Saving the SPA snapshot also materializes a scoring `org_chart` tree for team/person metrics when import members are present. Parse-only responses may include duplicateEmailWarnings, identityEmailPreview (cross-check against connected AI tool seat rosters), and importWarnings when roster preview is unavailable.
          */
         post: operations["postOrgChartImport"];
         delete?: 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;
@@ -3845,6 +3905,26 @@ export interface components {
             bitbucketNickname?: string;
             /** @description Bitbucket account UUID (e.g. "{aeefb6b0-...}") to attribute merged PRs and reviews to this person in productivity ingest. Preferred over bitbucketNickname — Bitbucket PR payloads expose a stable uuid but not nickname. Resolves to the same person_id (email) as githubUsername. */
             bitbucketUuid?: string;
+            /** @description Optional comma-separated work emails that map to the same person for AI tool spend/usage (mirrors multi-login github_username). Primary email remains canonical person_id. */
+            alternateEmails?: string;
+        };
+        OrgChartEmailOwnershipDto: {
+            email: string;
+            employeeId: string;
+            name: string;
+            isPrimary: boolean;
+        };
+        OrgChartEmailDuplicateDto: {
+            email: string;
+            owners: components["schemas"]["OrgChartEmailOwnershipDto"][];
+        };
+        OrgChartIdentityEmailPreviewDto: {
+            employeeId: string;
+            name: string;
+            primaryEmail: string;
+            alternateEmails: string[];
+            rosterMatches: string[];
+            warnings: string[];
         };
         UpdateMyOrgChartMemberBodyDto: {
             name?: string;
@@ -3855,12 +3935,20 @@ export interface components {
             githubUsername?: string;
             bitbucketNickname?: string;
             bitbucketUuid?: string;
+            /** @description Comma-separated alternate work emails for AI tool attribution. */
+            alternateEmails?: string;
         };
         OrgChartImportResultDto: {
             persons: components["schemas"]["OrgChartPersonDto"][];
             errors: string[];
             /** @description Parse-only preview of identity rows that would not match HRIS persons */
             unmatchedPreview?: components["schemas"]["OrgChartUnmatchedIdentitySampleDto"][];
+            /** @description Emails claimed by more than one org-chart row (primary or alternate) */
+            duplicateEmailWarnings?: components["schemas"]["OrgChartEmailDuplicateDto"][];
+            /** @description Cross-check of primary and alternate emails against connected AI tool seat rosters */
+            identityEmailPreview?: components["schemas"]["OrgChartIdentityEmailPreviewDto"][];
+            /** @description Non-fatal import advisories (for example when AI tool roster preview could not be loaded) */
+            importWarnings?: string[];
         };
         OrgChartSaveResultDto: {
             ok: boolean;
@@ -7096,6 +7184,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 +7249,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 */
@@ -8484,6 +8598,9 @@ export type OrgChartTreeNodeDto = components['schemas']['OrgChartTreeNodeDto'];
 export type ScoringOrgChartDto = components['schemas']['ScoringOrgChartDto'];
 export type OrgChartDto = components['schemas']['OrgChartDto'];
 export type OrgChartPersonDto = components['schemas']['OrgChartPersonDto'];
+export type OrgChartEmailOwnershipDto = components['schemas']['OrgChartEmailOwnershipDto'];
+export type OrgChartEmailDuplicateDto = components['schemas']['OrgChartEmailDuplicateDto'];
+export type OrgChartIdentityEmailPreviewDto = components['schemas']['OrgChartIdentityEmailPreviewDto'];
 export type UpdateMyOrgChartMemberBodyDto = components['schemas']['UpdateMyOrgChartMemberBodyDto'];
 export type OrgChartImportResultDto = components['schemas']['OrgChartImportResultDto'];
 export type OrgChartSaveResultDto = components['schemas']['OrgChartSaveResultDto'];
@@ -8761,6 +8878,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'];
@@ -12923,6 +13043,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?: {
@@ -17482,6 +17635,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;
@@ -17579,6 +17756,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 */