@thinkai/tai-api-contract 2.45.0-pr.855.f75b4bb3 → 2.45.1

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.44.0
+  version: 2.45.1
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -2459,10 +2459,13 @@ 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.
+        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.
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - name: provider
@@ -2475,8 +2478,9 @@ paths:
           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`.
+            Force a full history re-sync instead of the incremental window (Enterprise: 6 months;
+            Team: `spendHistoryDays`-day daily-usage window; Cursor: spend/model/daily backfill reset
+            over `spendHistoryDays`). Truthy only for `true` or `1`.
           schema:
             type: string
             enum: ["true", "1"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.45.0-pr.855.f75b4bb3",
+  "version": "2.45.1",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,8 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@stoplight/spectral-cli": "^6.16.0",
-    "@types/node": "^25.9.3",
+    "@stoplight/spectral-cli": "^6.16.1",
+    "@types/node": "^26.0.1",
     "jsonpath-plus": "^10.3.0",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"

package/src/generated/openapi.ts

@@ -842,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. 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.
+         * @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.
          */
         post: operations["refreshWorkspaceAiTool"];
         delete?: never;
@@ -7101,7 +7101,7 @@ export interface operations {
     refreshWorkspaceAiTool: {
         parameters: {
             query?: {
-                /** @description Force a full re-sync (ignore the daily-usage watermark, re-pull the full initial window). Truthy only for `true` or `1`. */
+                /** @description Force a full history re-sync instead of the incremental window (Enterprise: 6 months; Team: `spendHistoryDays`-day daily-usage window; Cursor: spend/model/daily backfill reset over `spendHistoryDays`). Truthy only for `true` or `1`. */
                 full?: "true" | "1";
             };
             header?: never;