@thinkai/tai-api-contract 2.43.0 → 2.45.0-pr.855.c0f2ad3f

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}/...`.
@@ -2459,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
@@ -2467,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
@@ -8124,6 +8137,29 @@ components:
           format: date-time
           description: When the pending install request was recorded.
 
+    GithubSetupInProgressDto:
+      type: object
+      additionalProperties: false
+      required: [kind, startedAt, expiresAt]
+      properties:
+        kind:
+          type: string
+          enum: [install_started, account_picker_ready]
+          description: >
+            install_started — user opened GitHub App install but callback not completed;
+            account_picker_ready — user OAuth completed and org picker session is active.
+        startedAt:
+          type: string
+          format: date-time
+        expiresAt:
+          type: string
+          format: date-time
+        pickerSessionId:
+          type: string
+          minLength: 8
+          maxLength: 128
+          description: Present when kind is account_picker_ready; use with GET connectable-accounts.
+
     GithubActionsWorkflowPreviewDto:
       type: object
       additionalProperties: false
@@ -8211,6 +8247,13 @@ components:
           allOf:
             - $ref: "#/components/schemas/GithubPendingApprovalDto"
           description: Present when an org admin must approve the GitHub App install request.
+        setupInProgress:
+          nullable: true
+          allOf:
+            - $ref: "#/components/schemas/GithubSetupInProgressDto"
+          description: >
+            Present when GitHub connect was started but not completed (install OAuth state or
+            account-picker session still active). Omitted when pendingApproval is set.
         installationId:
           type: string
           nullable: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.43.0",
+  "version": "2.45.0-pr.855.c0f2ad3f",
   "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.
+         * @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;
@@ -3269,6 +3269,19 @@ export interface components {
              */
             pendingSince: string;
         };
+        GithubSetupInProgressDto: {
+            /**
+             * @description install_started — user opened GitHub App install but callback not completed; account_picker_ready — user OAuth completed and org picker session is active.
+             * @enum {string}
+             */
+            kind: "install_started" | "account_picker_ready";
+            /** Format: date-time */
+            startedAt: string;
+            /** Format: date-time */
+            expiresAt: string;
+            /** @description Present when kind is account_picker_ready; use with GET connectable-accounts. */
+            pickerSessionId?: string;
+        };
         GithubActionsWorkflowPreviewDto: {
             /** @description Approximate workflow count from recent API sample (best effort). */
             workflows?: number;
@@ -3312,6 +3325,8 @@ export interface components {
             permissionsUpgradeRequired: boolean;
             /** @description Present when an org admin must approve the GitHub App install request. */
             pendingApproval?: components["schemas"]["GithubPendingApprovalDto"] | null;
+            /** @description Present when GitHub connect was started but not completed (install OAuth state or account-picker session still active). Omitted when pendingApproval is set. */
+            setupInProgress?: components["schemas"]["GithubSetupInProgressDto"] | null;
             installationId?: string | null;
             account?: components["schemas"]["GithubAccountDto"] | null;
             /** @description Paginated merged installation repositories when `installed` is true. */
@@ -4704,6 +4719,7 @@ export type RepoEligibilityLimitsDto = components['schemas']['RepoEligibilityLim
 export type GithubMissingPermissionDto = components['schemas']['GithubMissingPermissionDto'];
 export type GithubInstallationSummaryDto = components['schemas']['GithubInstallationSummaryDto'];
 export type GithubPendingApprovalDto = components['schemas']['GithubPendingApprovalDto'];
+export type GithubSetupInProgressDto = components['schemas']['GithubSetupInProgressDto'];
 export type GithubActionsWorkflowPreviewDto = components['schemas']['GithubActionsWorkflowPreviewDto'];
 export type GithubActionsIntegrationStatusDto = components['schemas']['GithubActionsIntegrationStatusDto'];
 export type GithubActionsEnableResponseDto = components['schemas']['GithubActionsEnableResponseDto'];
@@ -7084,7 +7100,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"];