@thinkai/tai-api-contract 2.130.0 → 2.132.0

package/src/generated/openapi.ts

@@ -1544,7 +1544,7 @@ export interface paths {
         };
         /**
          * GitHub App installation status for workspace
-         * @description Returns whether a GitHub App installation is linked and cached repo metadata. When no installation exists, returns 200 with `installed: false` (never 404 for missing install). Use `refresh=true` to bypass cache and re-list repositories from GitHub, and to run inline productivity ingest (`on_demand`) for the current UTC week when backfill phase is `complete`.
+         * @description Returns whether a GitHub App installation is linked and cached repo metadata. When no installation exists, returns 200 with `installed: false` (never 404 for missing install). Use `refresh=true` to bypass cache and re-list repositories from GitHub, and to run inline productivity ingest (`on_demand`) for the current UTC week.
          */
         get: operations["getWorkspaceGithubInstallationStatus"];
         put?: never;
@@ -3382,6 +3382,77 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/origin-prompt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Origin prompt and symbol-index status for one repository index */
+        get: operations["getCodeChatOriginPrompt"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/context-pack": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reader context pack for one repository index
+         * @description Reader export. The agent tool remains POST …/code-chat/tools/get_context_pack.
+         */
+        get: operations["getCodeChatRepoContextPack"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-chat/symbols/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Search stored symbols in the workspace */
+        get: operations["searchCodeChatSymbols"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-chat/symbols/refs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List references for a stored symbol */
+        get: operations["listCodeChatSymbolRefs"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-chat/analyze/symbols": {
         parameters: {
             query?: never;
@@ -4053,7 +4124,7 @@ export interface paths {
         };
         /**
          * Ingest / backfill data coverage
-         * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub, AI usage/spend per provider, SDLC components, monitoring, HRIS). Aggregates existing watermarks and stored day/week evidence — does not trigger ingest or refresh. Requires workspace membership. Disconnected sources are omitted.
+         * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub, AI usage/spend per provider, SDLC components, monitoring, HRIS). Aggregates existing watermarks and stored day/week evidence — does not trigger ingest or refresh. Productivity detail may include `selfHeal` (latest depth scan and week reconcile) read from stored activity rows; this GET does not run a scan. `selfHeal` is null when neither event exists. Requires workspace membership. Disconnected sources are omitted.
          */
         get: operations["getWorkspaceIngestCoverage"];
         put?: never;
@@ -7989,6 +8060,26 @@ export interface components {
             gaps?: components["schemas"]["IngestCoverageGapDto"][];
             lastErrorKind?: string | null;
         };
+        /** @description Latest depth scan read from stored activity. `capturePercent` is the minimum existing capture ratio over that scan's repo checks with a GitHub merge count, or null when none qualify. */
+        IngestCoverageProductivityDepthScanDto: {
+            /** Format: date-time */
+            completedAt: string | null;
+            reposScanned: number;
+            /** @description Metadata underIngestedCount from the completed depth-scan event. */
+            gapCount: number;
+            capturePercent: number | null;
+            weeksQueued: number;
+        };
+        IngestCoverageProductivityWeekReconcileDto: {
+            /** Format: date-time */
+            completedAt: string | null;
+            weeksChecked: number;
+            weeksQueued: number;
+        };
+        IngestCoverageProductivitySelfHealDto: {
+            depthScan: components["schemas"]["IngestCoverageProductivityDepthScanDto"];
+            weekReconcile: components["schemas"]["IngestCoverageProductivityWeekReconcileDto"];
+        };
         IngestCoverageProductivityDetailDto: {
             /** @enum {string|null} */
             phase?: "recent" | "historical" | "complete" | null;
@@ -7998,6 +8089,8 @@ export interface components {
             failedRepoCount?: number;
             coveragePercent?: number | null;
             repos?: components["schemas"]["IngestCoverageProductivityRepoDto"][];
+            /** @description Latest depth-scan and week-reconcile summary from stored activity rows. Null when neither event exists. The coverage GET does not run a scan. */
+            selfHeal?: components["schemas"]["IngestCoverageProductivitySelfHealDto"] | null;
         };
         IngestCoverageFactFamilyDto: {
             /** @enum {string} */
@@ -9168,6 +9261,16 @@ export interface components {
             kind: string;
             summary?: string;
             startLine?: number;
+            label?: string;
+            symbol?: string;
+            role?: string;
+            /** @enum {string} */
+            precision?: "scip" | "structural";
+            language?: string;
+            /** @enum {string} */
+            source?: "scip" | "structural" | "codegraph";
+            /** Format: uuid */
+            indexId?: string;
             /** Format: uuid */
             repoId?: string;
             repoName?: string;
@@ -9175,6 +9278,23 @@ export interface components {
         };
         CodeChatSymbolHitListDto: {
             items: components["schemas"]["CodeChatSymbolHitDto"][];
+            /** @enum {string} */
+            source?: "scip_store" | "codegraph";
+        };
+        CodeChatOriginPromptDto: {
+            originPromptMd?: string | null;
+            scipStatus?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        CodeChatRepoContextPackDto: {
+            markdown: string;
+            tokenEstimate: number;
+            maxTokens: number;
+            sectionsIncluded: string[];
+            pack?: {
+                [key: string]: unknown;
+            };
         };
         CodeChatReferenceQueryBodyDto: {
             symbol: string;
@@ -10219,6 +10339,9 @@ export type WorkspaceAbsenceListDto = components['schemas']['WorkspaceAbsenceLis
 export type IngestCoverageGapDto = components['schemas']['IngestCoverageGapDto'];
 export type IngestCoverageLastRunDto = components['schemas']['IngestCoverageLastRunDto'];
 export type IngestCoverageProductivityRepoDto = components['schemas']['IngestCoverageProductivityRepoDto'];
+export type IngestCoverageProductivityDepthScanDto = components['schemas']['IngestCoverageProductivityDepthScanDto'];
+export type IngestCoverageProductivityWeekReconcileDto = components['schemas']['IngestCoverageProductivityWeekReconcileDto'];
+export type IngestCoverageProductivitySelfHealDto = components['schemas']['IngestCoverageProductivitySelfHealDto'];
 export type IngestCoverageProductivityDetailDto = components['schemas']['IngestCoverageProductivityDetailDto'];
 export type IngestCoverageFactFamilyDto = components['schemas']['IngestCoverageFactFamilyDto'];
 export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiDetailDto'];
@@ -10340,6 +10463,8 @@ export type CodeChatWikiOkfExportDto = components['schemas']['CodeChatWikiOkfExp
 export type CodeChatSymbolQueryBodyDto = components['schemas']['CodeChatSymbolQueryBodyDto'];
 export type CodeChatSymbolHitDto = components['schemas']['CodeChatSymbolHitDto'];
 export type CodeChatSymbolHitListDto = components['schemas']['CodeChatSymbolHitListDto'];
+export type CodeChatOriginPromptDto = components['schemas']['CodeChatOriginPromptDto'];
+export type CodeChatRepoContextPackDto = components['schemas']['CodeChatRepoContextPackDto'];
 export type CodeChatReferenceQueryBodyDto = components['schemas']['CodeChatReferenceQueryBodyDto'];
 export type CodeChatReferenceHitDto = components['schemas']['CodeChatReferenceHitDto'];
 export type CodeChatReferenceHitListDto = components['schemas']['CodeChatReferenceHitListDto'];
@@ -14729,7 +14854,7 @@ export interface operations {
     getWorkspaceGithubInstallationStatus: {
         parameters: {
             query?: {
-                /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub. When productivity backfill phase is `complete`, also triggers inline `on_demand` ingest for the current UTC week (gap-fill only when metrics are missing). Response includes `productivityRefreshInProgress` while the workspace advisory lock is held. */
+                /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub, then poll and merge productivity metrics for the current UTC week even while historical backfill is active or metrics already exist. Response includes `productivityRefreshInProgress` while the workspace advisory lock is held. */
                 refresh?: boolean;
                 /** @description When true, re-fetch GitHub App and installation permission metadata (used by the login permission gate after the user approves on GitHub). Clears App-permission and product-settings caches so the next `productSettingsRefresh` re-probes. Does not itself call alert-list APIs; use `productSettingsRefresh` for that. */
                 permissionsRefresh?: boolean;
@@ -19210,6 +19335,133 @@ export interface operations {
             };
         };
     };
+    getCodeChatOriginPrompt: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                indexId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Stored origin prompt and symbol-index status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatOriginPromptDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    getCodeChatRepoContextPack: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                indexId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Context pack markdown and section list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatRepoContextPackDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Index not ready */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    searchCodeChatSymbols: {
+        parameters: {
+            query: {
+                q: string;
+                repoId?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Symbol hits */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatSymbolHitListDto"];
+                };
+            };
+            /** @description Missing query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    listCodeChatSymbolRefs: {
+        parameters: {
+            query: {
+                symbol: string;
+                repoId?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Reference hits */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatSymbolHitListDto"];
+                };
+            };
+            /** @description Missing symbol */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     analyzeCodeChatSymbols: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -1315,6 +1315,34 @@ export interface IngestCoverageProductivityRepoDto {
   lastErrorKind?: string | null;
 }
 
+/** Latest depth-scan summary read from activity rows. Does not start a scan. */
+export interface IngestCoverageProductivityDepthScanDto {
+  /** Newest `productivity.ingest.depth_scan_completed` time, or null when none. */
+  completedAt: string | null;
+  reposScanned: number;
+  /** Metadata `underIngestedCount` on that completed event (0 when the scan found none). */
+  gapCount: number;
+  /**
+   * Minimum `capturePercent(platformPrs, githubMerged180d)` over that scan's repo checks
+   * with `githubMerged180d` > 0. Null when no such row.
+   */
+  capturePercent: number | null;
+  weeksQueued: number;
+}
+
+/** Latest week-reconcile summary read from activity rows. */
+export interface IngestCoverageProductivityWeekReconcileDto {
+  /** Newest `productivity.ingest.week_reconcile` time, or null when none. */
+  completedAt: string | null;
+  weeksChecked: number;
+  weeksQueued: number;
+}
+
+export interface IngestCoverageProductivitySelfHealDto {
+  depthScan: IngestCoverageProductivityDepthScanDto;
+  weekReconcile: IngestCoverageProductivityWeekReconcileDto;
+}
+
 export interface IngestCoverageProductivityDetailDto {
   phase?: "recent" | "historical" | "complete" | null;
   historicalWeekStart?: string | null;
@@ -1323,6 +1351,11 @@ export interface IngestCoverageProductivityDetailDto {
   failedRepoCount?: number;
   coveragePercent?: number | null;
   repos?: IngestCoverageProductivityRepoDto[];
+  /**
+   * Null when the pipeline exists but no depth-scan completed event and no week-reconcile
+   * event are stored. Absent from pipelines that are omitted.
+   */
+  selfHeal?: IngestCoverageProductivitySelfHealDto | null;
 }
 
 export interface IngestCoverageFactFamilyDto {