@thinkai/tai-api-contract 2.45.0 → 2.46.0-pr.858.7e24f603

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.44.0
+  version: 2.46.0
   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"]
@@ -8312,6 +8316,11 @@ components:
           minLength: 8
           maxLength: 128
           description: OAuth org-picker session id; when set, server prefers the session's stored returnPath over the body returnPath.
+        spaOrigin:
+          type: string
+          format: uri
+          maxLength: 256
+          description: SPA origin to redirect back to after OAuth; must match server spaOrigins allowlist.
 
     GithubInstallUrlResponseDto:
       type: object
@@ -8335,6 +8344,11 @@ components:
           type: string
           pattern: '^/[A-Za-z0-9/_\-\?\=&]*$'
           maxLength: 256
+        spaOrigin:
+          type: string
+          format: uri
+          maxLength: 256
+          description: SPA origin to redirect back to after OAuth; must match server spaOrigins allowlist.
 
     GithubUserAuthorizeUrlResponseDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.45.0",
+  "version": "2.46.0-pr.858.7e24f603",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

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;
@@ -3357,6 +3357,11 @@ export interface components {
             returnPath?: string;
             /** @description OAuth org-picker session id; when set, server prefers the session's stored returnPath over the body returnPath. */
             pickerSession?: string;
+            /**
+             * Format: uri
+             * @description SPA origin to redirect back to after OAuth; must match server spaOrigins allowlist.
+             */
+            spaOrigin?: string;
         };
         GithubInstallUrlResponseDto: {
             /** Format: uri */
@@ -3365,6 +3370,11 @@ export interface components {
         };
         GithubUserAuthorizeUrlRequestDto: {
             returnPath?: string;
+            /**
+             * Format: uri
+             * @description SPA origin to redirect back to after OAuth; must match server spaOrigins allowlist.
+             */
+            spaOrigin?: string;
         };
         GithubUserAuthorizeUrlResponseDto: {
             /** Format: uri */
@@ -7101,7 +7111,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;