@thinkai/tai-api-contract 2.122.0 → 2.124.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.122.0
+  version: 2.124.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -3127,9 +3127,11 @@ paths:
       summary: Rebuild SDLC DORA/CI daily rollups for a day range
       operationId: rebuildSdlcRollups
       description: >
-        Rebuilds DORA/CI daily rollups for this workspace from stored dashboard
+        Queues a rebuild of DORA/CI daily rollups for this workspace from stored dashboard
         productivity history for the inclusive `from`/`to` UTC day range (max 90 days).
-        Does not re-pull GitHub. Returns 409 when another rebuild holds the advisory lock.
+        Does not re-pull GitHub. Returns immediately with `{ ok: true }` while the rebuild
+        runs under an advisory lock; ingest-coverage reports `sdlc_github` as `in_progress`
+        until the lock is released. Returns 409 when another rebuild holds the advisory lock.
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - name: from
@@ -3148,12 +3150,12 @@ paths:
             format: date
       responses:
         "200":
-          description: Rebuild completed
+          description: Rebuild accepted and running asynchronously
           content:
             application/json:
               schema:
                 type: object
-                required: [ok, rollupRows]
+                required: [ok]
                 properties:
                   ok:
                     type: boolean
@@ -3161,9 +3163,11 @@ paths:
                   rollupRows:
                     type: integer
                     minimum: 0
+                    description: >
+                      Optional. Omitted when the rebuild is queued asynchronously
+                      (current behavior).
               example:
                 ok: true
-                rollupRows: 42
         "400":
           description: >
             Invalid range. Stable `error` codes: `invalid_day_range` (missing pair,
@@ -4543,8 +4547,11 @@ paths:
       summary: Refresh AI tool integration snapshots
       operationId: refreshWorkspaceAiTool
       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.
+        Provider-agnostic refresh. Queues work for `ai-tool-refresher` and returns immediately
+        with `{ ok: true }` when accepted. Progress is visible via ingest-coverage
+        (`ai.refreshInProgress`) and the provider status endpoint while the on-demand flag
+        (or advisory lock) is held. Returns 409 when an advisory-lock refresh is already in
+        progress. Returns 404 when the provider source is missing.
         Pass `full=true` to force a full re-sync that re-pulls the full history instead of the
         incremental window, used to backfill historical months. Provider-specific behavior:
         Claude Enterprise re-pulls six calendar months of daily usage; Claude Team widens its
@@ -4601,7 +4608,9 @@ paths:
             format: date
       responses:
         "200":
-          description: Refresh result
+          description: >
+            Refresh accepted and queued for `ai-tool-refresher`. Upstream auth/rate/network
+            failures are reported later via refresh status / ingest-coverage, not on this response.
           content:
             application/json:
               schema:
@@ -4609,13 +4618,12 @@ paths:
               examples:
                 ok:
                   value: { ok: true }
-                invalid_token:
-                  value: { ok: false, error: "invalid_token" }
         "400":
           description: >
-            Invalid request — day-range validation failed. Stable `error` codes:
-            `invalid_day_range` (missing pair, bad calendar date, or from > to) and
-            `full_and_day_range_conflict` (`full` combined with `from`/`to`).
+            Invalid request. Stable `error` codes: `invalid_day_range` (missing pair,
+            bad calendar date, or from > to), `full_and_day_range_conflict` (`full`
+            combined with `from`/`to`), and `invalid_provider` (path provider is not
+            a supported AI-tool integration id).
           content:
             application/json:
               schema:
@@ -4625,6 +4633,8 @@ paths:
                   value: { ok: false, error: "invalid_day_range" }
                 full_and_day_range_conflict:
                   value: { ok: false, error: "full_and_day_range_conflict" }
+                invalid_provider:
+                  value: { ok: false, error: "invalid_provider" }
         "401":
           $ref: "#/components/responses/Unauthorized"
         "403":
@@ -4639,7 +4649,9 @@ paths:
                 ok: false
                 error: "no_source"
         "409":
-          description: Refresh already in progress
+          description: >
+            Refresh already in progress — advisory lock held, or an on-demand refresh
+            is already queued for this workspace/provider.
           content:
             application/json:
               schema:
@@ -17748,6 +17760,9 @@ components:
         - hris.zelt.sync_started
         - hris.zelt.sync_completed
         - hris.zelt.sync_failed
+        - hris.hibob.sync_started
+        - hris.hibob.sync_completed
+        - hris.hibob.sync_failed
         - hris.sync_started
         - hris.sync_completed
         - hris.sync_failed

package/package.json

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

package/src/generated/openapi.ts

@@ -1121,7 +1121,7 @@ export interface paths {
         put?: never;
         /**
          * Rebuild SDLC DORA/CI daily rollups for a day range
-         * @description Rebuilds DORA/CI daily rollups for this workspace from stored dashboard productivity history for the inclusive `from`/`to` UTC day range (max 90 days). Does not re-pull GitHub. Returns 409 when another rebuild holds the advisory lock.
+         * @description Queues a rebuild of DORA/CI daily rollups for this workspace from stored dashboard productivity history for the inclusive `from`/`to` UTC day range (max 90 days). Does not re-pull GitHub. Returns immediately with `{ ok: true }` while the rebuild runs under an advisory lock; ingest-coverage reports `sdlc_github` as `in_progress` until the lock is released. Returns 409 when another rebuild holds the advisory lock.
          */
         post: operations["rebuildSdlcRollups"];
         delete?: never;
@@ -1650,7 +1650,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. Pass `full=true` to force a full re-sync that re-pulls the full history instead of the incremental window, used to backfill historical months. Provider-specific behavior: Claude Enterprise re-pulls six calendar months of daily usage; Claude Team widens its daily-usage window to the configured history depth (`spendHistoryDays`, default 180 days); Cursor resets its spend/model/daily backfill cursors so the full `spendHistoryDays` window re-ingests from the retention floor even when the backfill was already complete. Omitted/false performs a normal incremental refresh. Pass `from` and `to` (UTC `YYYY-MM-DD`) together to re-ingest only that inclusive day range without resetting incremental watermarks; mutually exclusive with `full`. Day-range behavior is provider-specific: all providers re-pull generic daily usage for the window (Cursor does this via the spend-daily path instead of a duplicate top-level poll); Cursor additionally re-ingests spend/model daily for the window without resetting backfill cursors. Claude Enterprise model/product/engagement ingest paths are not day-range scoped and continue to use their normal refresh windows.
+         * @description Provider-agnostic refresh. Queues work for `ai-tool-refresher` and returns immediately with `{ ok: true }` when accepted. Progress is visible via ingest-coverage (`ai.refreshInProgress`) and the provider status endpoint while the on-demand flag (or advisory lock) is held. Returns 409 when an advisory-lock refresh is already in progress. Returns 404 when the provider source is missing. Pass `full=true` to force a full re-sync that re-pulls the full history instead of the incremental window, used to backfill historical months. Provider-specific behavior: Claude Enterprise re-pulls six calendar months of daily usage; Claude Team widens its daily-usage window to the configured history depth (`spendHistoryDays`, default 180 days); Cursor resets its spend/model/daily backfill cursors so the full `spendHistoryDays` window re-ingests from the retention floor even when the backfill was already complete. Omitted/false performs a normal incremental refresh. Pass `from` and `to` (UTC `YYYY-MM-DD`) together to re-ingest only that inclusive day range without resetting incremental watermarks; mutually exclusive with `full`. Day-range behavior is provider-specific: all providers re-pull generic daily usage for the window (Cursor does this via the spend-daily path instead of a duplicate top-level poll); Cursor additionally re-ingests spend/model daily for the window without resetting backfill cursors. Claude Enterprise model/product/engagement ingest paths are not day-range scoped and continue to use their normal refresh windows.
          */
         post: operations["refreshWorkspaceAiTool"];
         delete?: never;
@@ -7620,7 +7620,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
         ActivityLogActorDto: {
             /** Format: uuid */
             userId: string;
@@ -13038,7 +13038,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Rebuild completed */
+            /** @description Rebuild accepted and running asynchronously */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -13046,14 +13046,14 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "ok": true,
-                     *       "rollupRows": 42
+                     *       "ok": true
                      *     }
                      */
                     "application/json": {
                         /** @enum {boolean} */
                         ok: true;
-                        rollupRows: number;
+                        /** @description Optional. Omitted when the rebuild is queued asynchronously (current behavior). */
+                        rollupRows?: number;
                     };
                 };
             };
@@ -14541,7 +14541,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Refresh result */
+            /** @description Refresh accepted and queued for `ai-tool-refresher`. Upstream auth/rate/network failures are reported later via refresh status / ingest-coverage, not on this response. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -14550,7 +14550,7 @@ export interface operations {
                     "application/json": components["schemas"]["AiToolRefreshResponseDto"];
                 };
             };
-            /** @description Invalid request — day-range validation failed. Stable `error` codes: `invalid_day_range` (missing pair, bad calendar date, or from > to) and `full_and_day_range_conflict` (`full` combined with `from`/`to`). */
+            /** @description Invalid request. Stable `error` codes: `invalid_day_range` (missing pair, bad calendar date, or from > to), `full_and_day_range_conflict` (`full` combined with `from`/`to`), and `invalid_provider` (path provider is not a supported AI-tool integration id). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -14576,7 +14576,7 @@ export interface operations {
                     "application/json": components["schemas"]["AiToolRefreshResponseDto"];
                 };
             };
-            /** @description Refresh already in progress */
+            /** @description Refresh already in progress — advisory lock held, or an on-demand refresh is already queued for this workspace/provider. */
             409: {
                 headers: {
                     [name: string]: unknown;