@thinkai/tai-api-contract 2.55.0 → 2.56.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.55.0
+  version: 2.56.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -4666,6 +4666,53 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/agentic-foundation/repo-scope:
+    put:
+      tags: [AgenticFoundation]
+      summary: Update Agentic Foundation repository scope
+      description: >
+        Bulk include/exclude materialized repos from Agentic Foundation by toggling the existing
+        `user_removed` archive state. Excluded repos remain integrated for productivity metrics.
+        Only workspace admins may call this endpoint. Partial failures are reported per repo.
+      operationId: putAgenticFoundationRepoScope
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PutAgenticFoundationRepoScopeBodyDto"
+            example:
+              changes:
+                - repoId: 00000000-0000-0000-0000-000000000101
+                  included: false
+                - repoId: 00000000-0000-0000-0000-000000000102
+                  included: true
+      responses:
+        "200":
+          description: Scope changes applied (possibly with per-repo failures)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PutAgenticFoundationRepoScopeResponseDto"
+        "400":
+          description: Invalid request body
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/agentic-foundation/dashboard:
     get:
       tags: [AgenticFoundation]
@@ -11129,8 +11176,8 @@ components:
         archivedReason:
           type: string
           nullable: true
-          enum: [github_removed, installation_disconnected, installation_replaced, superseded]
-          description: Why the repo was archived. Only present when `archivedAt` is set.
+          enum: [github_removed, installation_disconnected, installation_replaced, superseded, user_removed]
+          description: Why the repo was archived. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
         eligibilityStatus:
           type: string
           enum: [eligible, ineligible]
@@ -11273,7 +11320,7 @@ components:
         archivedReason:
           type: string
           nullable: true
-          enum: [github_removed, installation_disconnected, installation_replaced, superseded]
+          enum: [github_removed, installation_disconnected, installation_replaced, superseded, user_removed]
         eligibilityStatus:
           type: string
           enum: [eligible, ineligible]
@@ -12453,6 +12500,77 @@ components:
           nullable: true
           description: ID of the freshly enqueued readiness scan run (only present on re-add).
 
+    PutAgenticFoundationRepoScopeChangeDto:
+      type: object
+      required: [repoId, included]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        included:
+          type: boolean
+          description: >
+            `true` to include in Agentic Foundation scope (unarchive user_removed).
+            `false` to exclude (soft-archive with archived_reason user_removed).
+
+    PutAgenticFoundationRepoScopeBodyDto:
+      type: object
+      required: [changes]
+      properties:
+        changes:
+          type: array
+          minItems: 1
+          maxItems: 200
+          items:
+            $ref: "#/components/schemas/PutAgenticFoundationRepoScopeChangeDto"
+
+    PutAgenticFoundationRepoScopeAppliedDto:
+      type: object
+      required: [repoId, status]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        status:
+          type: string
+          enum: [Active, Inactive]
+        runId:
+          type: string
+          format: uuid
+          nullable: true
+
+    PutAgenticFoundationRepoScopeFailureDto:
+      type: object
+      required: [repoId, code, message]
+      properties:
+        repoId:
+          type: string
+          format: uuid
+        code:
+          type: string
+          enum:
+            - not_found
+            - scan_in_progress
+            - not_archived
+            - already_active
+            - system_archived
+            - forbidden
+        message:
+          type: string
+
+    PutAgenticFoundationRepoScopeResponseDto:
+      type: object
+      required: [applied, failures]
+      properties:
+        applied:
+          type: array
+          items:
+            $ref: "#/components/schemas/PutAgenticFoundationRepoScopeAppliedDto"
+        failures:
+          type: array
+          items:
+            $ref: "#/components/schemas/PutAgenticFoundationRepoScopeFailureDto"
+
     ActivityLogEventTypeDto:
       type: string
       description: Type of workspace lifecycle event.

package/package.json

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

package/src/generated/openapi.ts

@@ -1679,6 +1679,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/agentic-foundation/repo-scope": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Update Agentic Foundation repository scope
+         * @description Bulk include/exclude materialized repos from Agentic Foundation by toggling the existing `user_removed` archive state. Excluded repos remain integrated for productivity metrics. Only workspace admins may call this endpoint. Partial failures are reported per repo.
+         */
+        put: operations["putAgenticFoundationRepoScope"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/agentic-foundation/dashboard": {
         parameters: {
             query?: never;
@@ -4670,10 +4690,10 @@ export interface components {
              */
             archivedAt?: string | null;
             /**
-             * @description Why the repo was archived. Only present when `archivedAt` is set.
+             * @description Why the repo was archived. `user_removed` means excluded from Agentic Foundation scope only. Only present when `archivedAt` is set.
              * @enum {string|null}
              */
-            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | null;
+            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
             /**
              * @description Whether the repo can be analyzed (#44/#729). Language support no longer makes a repo `ineligible` — a missing v1-supported stack is surfaced via `warnings` and the repo stays analyzable. It becomes `ineligible` when the most recent scan hit a hard size/file-count limit (e.g. code-size or file-count exceeded): the repo is then restricted here too so this surface matches the GitHub connect list's size gate after the scan. Null until the first sync/scan computes it.
              * @enum {string|null}
@@ -4728,7 +4748,7 @@ export interface components {
             /** Format: date-time */
             archivedAt?: string | null;
             /** @enum {string|null} */
-            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | null;
+            archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | "user_removed" | null;
             /**
              * @description See RepoReadinessScoreDto.eligibilityStatus. Language support is advisory (#729) and surfaced via `warnings`.
              * @enum {string|null}
@@ -5254,6 +5274,34 @@ export interface components {
              */
             runId?: string | null;
         };
+        PutAgenticFoundationRepoScopeChangeDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @description `true` to include in Agentic Foundation scope (unarchive user_removed). `false` to exclude (soft-archive with archived_reason user_removed). */
+            included: boolean;
+        };
+        PutAgenticFoundationRepoScopeBodyDto: {
+            changes: components["schemas"]["PutAgenticFoundationRepoScopeChangeDto"][];
+        };
+        PutAgenticFoundationRepoScopeAppliedDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @enum {string} */
+            status: "Active" | "Inactive";
+            /** Format: uuid */
+            runId?: string | null;
+        };
+        PutAgenticFoundationRepoScopeFailureDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @enum {string} */
+            code: "not_found" | "scan_in_progress" | "not_archived" | "already_active" | "system_archived" | "forbidden";
+            message: string;
+        };
+        PutAgenticFoundationRepoScopeResponseDto: {
+            applied: components["schemas"]["PutAgenticFoundationRepoScopeAppliedDto"][];
+            failures: components["schemas"]["PutAgenticFoundationRepoScopeFailureDto"][];
+        };
         /**
          * @description Type of workspace lifecycle event.
          * @enum {string}
@@ -5817,6 +5865,11 @@ export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAi
 export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
 export type PatchRepoArchiveBodyDto = components['schemas']['PatchRepoArchiveBodyDto'];
 export type PatchRepoArchiveResponseDto = components['schemas']['PatchRepoArchiveResponseDto'];
+export type PutAgenticFoundationRepoScopeChangeDto = components['schemas']['PutAgenticFoundationRepoScopeChangeDto'];
+export type PutAgenticFoundationRepoScopeBodyDto = components['schemas']['PutAgenticFoundationRepoScopeBodyDto'];
+export type PutAgenticFoundationRepoScopeAppliedDto = components['schemas']['PutAgenticFoundationRepoScopeAppliedDto'];
+export type PutAgenticFoundationRepoScopeFailureDto = components['schemas']['PutAgenticFoundationRepoScopeFailureDto'];
+export type PutAgenticFoundationRepoScopeResponseDto = components['schemas']['PutAgenticFoundationRepoScopeResponseDto'];
 export type ActivityLogEventTypeDto = components['schemas']['ActivityLogEventTypeDto'];
 export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
 export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
@@ -10317,6 +10370,66 @@ export interface operations {
             };
         };
     };
+    putAgenticFoundationRepoScope: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "changes": [
+                 *         {
+                 *           "repoId": "00000000-0000-0000-0000-000000000101",
+                 *           "included": false
+                 *         },
+                 *         {
+                 *           "repoId": "00000000-0000-0000-0000-000000000102",
+                 *           "included": true
+                 *         }
+                 *       ]
+                 *     }
+                 */
+                "application/json": components["schemas"]["PutAgenticFoundationRepoScopeBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Scope changes applied (possibly with per-repo failures) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PutAgenticFoundationRepoScopeResponseDto"];
+                };
+            };
+            /** @description Invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAgenticFoundationDashboard: {
         parameters: {
             query?: never;