@thinkai/tai-api-contract 2.108.0 → 2.110.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.108.0
+  version: 2.110.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -8300,8 +8300,12 @@ paths:
         `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.
+        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.
       operationId: postOrgChartImport
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
@@ -9811,6 +9815,59 @@ components:
         bitbucketUuid:
           type: 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.
+        alternateEmails:
+          type: 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.
+
+    OrgChartEmailOwnershipDto:
+      type: object
+      additionalProperties: false
+      required: [email, employeeId, name, isPrimary]
+      properties:
+        email:
+          type: string
+        employeeId:
+          type: string
+        name:
+          type: string
+        isPrimary:
+          type: boolean
+
+    OrgChartEmailDuplicateDto:
+      type: object
+      additionalProperties: false
+      required: [email, owners]
+      properties:
+        email:
+          type: string
+        owners:
+          type: array
+          items:
+            $ref: "#/components/schemas/OrgChartEmailOwnershipDto"
+
+    OrgChartIdentityEmailPreviewDto:
+      type: object
+      additionalProperties: false
+      required: [employeeId, name, primaryEmail, alternateEmails, rosterMatches, warnings]
+      properties:
+        employeeId:
+          type: string
+        name:
+          type: string
+        primaryEmail:
+          type: string
+        alternateEmails:
+          type: array
+          items:
+            type: string
+        rosterMatches:
+          type: array
+          items:
+            type: string
+        warnings:
+          type: array
+          items:
+            type: string
 
     UpdateMyOrgChartMemberBodyDto:
       type: object
@@ -9832,6 +9889,9 @@ components:
           type: string
         bitbucketUuid:
           type: string
+        alternateEmails:
+          type: string
+          description: Comma-separated alternate work emails for AI tool attribution.
 
     OrgChartImportResultDto:
       type: object
@@ -9851,6 +9911,21 @@ components:
           description: Parse-only preview of identity rows that would not match HRIS persons
           items:
             $ref: "#/components/schemas/OrgChartUnmatchedIdentitySampleDto"
+        duplicateEmailWarnings:
+          type: array
+          description: Emails claimed by more than one org-chart row (primary or alternate)
+          items:
+            $ref: "#/components/schemas/OrgChartEmailDuplicateDto"
+        identityEmailPreview:
+          type: array
+          description: Cross-check of primary and alternate emails against connected AI tool seat rosters
+          items:
+            $ref: "#/components/schemas/OrgChartIdentityEmailPreviewDto"
+        importWarnings:
+          type: array
+          description: Non-fatal import advisories (for example when AI tool roster preview could not be loaded)
+          items:
+            type: string
 
     OrgChartSaveResultDto:
       type: object
@@ -16494,7 +16569,8 @@ components:
     PreferencesDto:
       type: object
       additionalProperties: false
-      required: [theme, sidebarCollapsed, timezone, dataRefreshInterval, notifications]
+      required:
+        [theme, sidebarCollapsed, timezone, dataRefreshInterval, notifications, buddyEnabled]
       properties:
         theme:
           $ref: "#/components/schemas/ThemePreference"
@@ -16507,6 +16583,12 @@ components:
           $ref: "#/components/schemas/DataRefreshInterval"
         notifications:
           $ref: "#/components/schemas/NotificationPreferencesDto"
+        buddyEnabled:
+          type: boolean
+          default: false
+          description: >
+            When true, show the ThinkAI Buddy mascot. Default and missing stored
+            values are false (opt-in only).
 
     ValidationIssueDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.108.0",
+  "version": "2.110.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -3358,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;
@@ -3905,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;
@@ -3915,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;
@@ -7052,6 +7080,11 @@ export interface components {
             timezone: string;
             dataRefreshInterval: components["schemas"]["DataRefreshInterval"];
             notifications: components["schemas"]["NotificationPreferencesDto"];
+            /**
+             * @description When true, show the ThinkAI Buddy mascot. Default and missing stored values are false (opt-in only).
+             * @default false
+             */
+            buddyEnabled: boolean;
         };
         ValidationIssueDto: {
             path: (string | number)[];
@@ -8570,6 +8603,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'];