@thinkai/tai-api-contract 2.42.0 → 2.44.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.42.0
+  version: 2.44.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -1355,6 +1355,61 @@ paths:
         "404":
           description: Workspace does not exist or malformed workspaceId
 
+  /workspaces/{workspaceId}/insights/persons/{personId}/erase:
+    post:
+      tags: [Workspace]
+      summary: Erase person-level insights data (workspace admin)
+      description: >
+        Workspace admin only. Deletes or anonymizes a person's developer-insights rows
+        for the workspace: org-chart node, person-scope dashboard metrics, AI-tool fact rows,
+        HRIS absences, and readiness run requester linkage. Granular categories default to
+        all enabled when the body is omitted. `personId` is the org-chart `person_id`
+        (typically work email); URL-encode the path segment (e.g. `alice%40example.com`).
+      operationId: eraseInsightsPerson
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: personId
+          in: path
+          required: true
+          description: Org-chart person_id (URL-encoded when it contains `@`).
+          schema:
+            type: string
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/EraseInsightsPersonBodyDto"
+            example:
+              orgChart: true
+              dashboardMetrics: true
+              aiToolData: true
+              absences: true
+              readinessAnonymize: true
+      responses:
+        "200":
+          description: Person data erased or anonymized
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/EraseInsightsPersonResultDto"
+        "400":
+          description: Invalid body or personId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace not found, malformed workspaceId, or person not in org chart
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/insights/ai-usage-spend/aggregated-teams:
     get:
       tags: [Workspace]
@@ -2404,6 +2459,10 @@ paths:
       description: >
         Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress.
         On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error.
+        Pass `full=true` to force a full re-sync that ignores the incremental daily-usage watermark and
+        re-pulls the full initial window (six calendar months for Claude Enterprise) — used to backfill
+        historical months after an ingestion-granularity change. Omitted/false performs a normal
+        incremental refresh.
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - name: provider
@@ -2412,6 +2471,15 @@ paths:
           schema:
             type: string
             enum: [cursor, claude]
+        - name: full
+          in: query
+          required: false
+          description: >
+            Force a full re-sync (ignore the daily-usage watermark, re-pull the full initial window).
+            Truthy only for `true` or `1`.
+          schema:
+            type: string
+            enum: ["true", "1"]
       responses:
         "200":
           description: Refresh result
@@ -5750,6 +5818,52 @@ components:
           type: string
           enum: [admin, editor, viewer]
 
+    EraseInsightsPersonBodyDto:
+      type: object
+      description: >
+        Granular person erasure categories. All default to true when omitted.
+      properties:
+        orgChart:
+          type: boolean
+          description: Remove the person node from `tai_workspace_config.org_chart`.
+        dashboardMetrics:
+          type: boolean
+          description: Delete person-scope rows in `tai_workspace_dashboard_metrics`.
+        aiToolData:
+          type: boolean
+          description: Delete AI-tool seats and fact rows keyed to the person.
+        absences:
+          type: boolean
+          description: Delete HRIS absence rows for the person's email.
+        readinessAnonymize:
+          type: boolean
+          description: Clear `requested_by_user_id` on readiness runs for matching app users.
+
+    EraseInsightsPersonResultDto:
+      type: object
+      required:
+        - deleted
+        - aiToolRowsDeleted
+        - absencesDeleted
+        - readinessRunsAnonymized
+        - auditEntriesAnonymized
+      properties:
+        deleted:
+          type: boolean
+          enum: [true]
+        aiToolRowsDeleted:
+          type: integer
+          minimum: 0
+        absencesDeleted:
+          type: integer
+          minimum: 0
+        readinessRunsAnonymized:
+          type: integer
+          minimum: 0
+        auditEntriesAnonymized:
+          type: integer
+          minimum: 0
+
     OrgChartNodeDto:
       type: object
       additionalProperties: false
@@ -9912,6 +10026,11 @@ components:
       type: string
       enum: [light, dark, system]
 
+    DataRefreshInterval:
+      type: string
+      enum: [off, 1m, 5m, 10m]
+      description: User-configured dashboard background refresh cadence.
+
     NotificationPreferencesDto:
       type: object
       additionalProperties: false
@@ -9933,7 +10052,7 @@ components:
     PreferencesDto:
       type: object
       additionalProperties: false
-      required: [theme, sidebarCollapsed, timezone, notifications]
+      required: [theme, sidebarCollapsed, timezone, dataRefreshInterval, notifications]
       properties:
         theme:
           $ref: "#/components/schemas/ThemePreference"
@@ -9942,6 +10061,8 @@ components:
         timezone:
           type: string
           description: IANA timezone name
+        dataRefreshInterval:
+          $ref: "#/components/schemas/DataRefreshInterval"
         notifications:
           $ref: "#/components/schemas/NotificationPreferencesDto"
 

package/package.json

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

package/src/generated/openapi.ts

@@ -446,6 +446,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/persons/{personId}/erase": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Erase person-level insights data (workspace admin)
+         * @description Workspace admin only. Deletes or anonymizes a person's developer-insights rows for the workspace: org-chart node, person-scope dashboard metrics, AI-tool fact rows, HRIS absences, and readiness run requester linkage. Granular categories default to all enabled when the body is omitted. `personId` is the org-chart `person_id` (typically work email); URL-encode the path segment (e.g. `alice%40example.com`).
+         */
+        post: operations["eraseInsightsPerson"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/insights/ai-usage-spend/aggregated-teams": {
         parameters: {
             query?: never;
@@ -822,7 +842,7 @@ export interface paths {
         put?: never;
         /**
          * Refresh AI tool integration snapshots
-         * @description Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress. On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error.
+         * @description Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress. On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error. Pass `full=true` to force a full re-sync that ignores the incremental daily-usage watermark and re-pulls the full initial window (six calendar months for Claude Enterprise) — used to backfill historical months after an ingestion-granularity change. Omitted/false performs a normal incremental refresh.
          */
         post: operations["refreshWorkspaceAiTool"];
         delete?: never;
@@ -2205,6 +2225,27 @@ export interface components {
             /** @enum {string} */
             role: "admin" | "editor" | "viewer";
         };
+        /** @description Granular person erasure categories. All default to true when omitted. */
+        EraseInsightsPersonBodyDto: {
+            /** @description Remove the person node from `tai_workspace_config.org_chart`. */
+            orgChart?: boolean;
+            /** @description Delete person-scope rows in `tai_workspace_dashboard_metrics`. */
+            dashboardMetrics?: boolean;
+            /** @description Delete AI-tool seats and fact rows keyed to the person. */
+            aiToolData?: boolean;
+            /** @description Delete HRIS absence rows for the person's email. */
+            absences?: boolean;
+            /** @description Clear `requested_by_user_id` on readiness runs for matching app users. */
+            readinessAnonymize?: boolean;
+        };
+        EraseInsightsPersonResultDto: {
+            /** @enum {boolean} */
+            deleted: true;
+            aiToolRowsDeleted: number;
+            absencesDeleted: number;
+            readinessRunsAnonymized: number;
+            auditEntriesAnonymized: number;
+        };
         OrgChartNodeDto: {
             id: string;
             name: string;
@@ -4059,6 +4100,11 @@ export interface components {
         } | unknown | unknown;
         /** @enum {string} */
         ThemePreference: "light" | "dark" | "system";
+        /**
+         * @description User-configured dashboard background refresh cadence.
+         * @enum {string}
+         */
+        DataRefreshInterval: "off" | "1m" | "5m" | "10m";
         NotificationPreferencesDto: {
             /** @description Sync/health status notifications. */
             status: boolean;
@@ -4074,6 +4120,7 @@ export interface components {
             sidebarCollapsed: boolean;
             /** @description IANA timezone name */
             timezone: string;
+            dataRefreshInterval: components["schemas"]["DataRefreshInterval"];
             notifications: components["schemas"]["NotificationPreferencesDto"];
         };
         ValidationIssueDto: {
@@ -4562,6 +4609,8 @@ export type TeamMemberDto = components['schemas']['TeamMemberDto'];
 export type TeamMemberListDto = components['schemas']['TeamMemberListDto'];
 export type InviteTeamMemberBodyDto = components['schemas']['InviteTeamMemberBodyDto'];
 export type UpdateTeamMemberRoleBodyDto = components['schemas']['UpdateTeamMemberRoleBodyDto'];
+export type EraseInsightsPersonBodyDto = components['schemas']['EraseInsightsPersonBodyDto'];
+export type EraseInsightsPersonResultDto = components['schemas']['EraseInsightsPersonResultDto'];
 export type OrgChartNodeDto = components['schemas']['OrgChartNodeDto'];
 export type OrgChartTreeNodeDto = components['schemas']['OrgChartTreeNodeDto'];
 export type ScoringOrgChartDto = components['schemas']['ScoringOrgChartDto'];
@@ -4740,6 +4789,7 @@ export type JourneyStepId = components['schemas']['JourneyStepId'];
 export type JourneyProgressDto = components['schemas']['JourneyProgressDto'];
 export type JourneyProgressUpdateDto = components['schemas']['JourneyProgressUpdateDto'];
 export type ThemePreference = components['schemas']['ThemePreference'];
+export type DataRefreshInterval = components['schemas']['DataRefreshInterval'];
 export type NotificationPreferencesDto = components['schemas']['NotificationPreferencesDto'];
 export type PreferencesDto = components['schemas']['PreferencesDto'];
 export type ValidationIssueDto = components['schemas']['ValidationIssueDto'];
@@ -5977,6 +6027,63 @@ export interface operations {
             };
         };
     };
+    eraseInsightsPerson: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Org-chart person_id (URL-encoded when it contains `@`). */
+                personId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /**
+                 * @example {
+                 *       "orgChart": true,
+                 *       "dashboardMetrics": true,
+                 *       "aiToolData": true,
+                 *       "absences": true,
+                 *       "readinessAnonymize": true
+                 *     }
+                 */
+                "application/json": components["schemas"]["EraseInsightsPersonBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Person data erased or anonymized */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EraseInsightsPersonResultDto"];
+                };
+            };
+            /** @description Invalid body or personId */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace not found, malformed workspaceId, or person not in org chart */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiUsageSpendAggregatedTeams: {
         parameters: {
             query?: {
@@ -6977,7 +7084,10 @@ export interface operations {
     };
     refreshWorkspaceAiTool: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Force a full re-sync (ignore the daily-usage watermark, re-pull the full initial window). Truthy only for `true` or `1`. */
+                full?: "true" | "1";
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];