@thinkai/tai-api-contract 2.141.0 → 2.143.0

package/dist/generated/openapi.d.ts

@@ -2399,6 +2399,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/report-center/exports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Record a Report Center PDF export
+         * @description Workspace admin (or platform admin) records that a Report Center PDF was downloaded. Inserts one `report.exported` activity-log row with the request body as secret-free metadata. Does not store PDF bytes. Members who are not workspace admins receive 403.
+         */
+        post: operations["recordReportCenterExport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/activity": {
         parameters: {
             query?: never;
@@ -8097,7 +8117,31 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported";
+        /** @description Metadata for a successful Report Center PDF download. Secret-free; no table payloads. Recorded as `report.exported` on the workspace activity log. */
+        ReportCenterExportRecordBodyDto: {
+            /** @description Applied insights range id (e.g. `30d`, `cr:2026-01-01:2026-01-31`). */
+            rangeId: string;
+            department: string;
+            team: string;
+            selectedProductivityTeamIds?: string[];
+            sectionIds: string[];
+            /** @description Preset id used as the starting point (e.g. `leadership`, `productivity`, `full`, `custom`). */
+            preset: string;
+            /** @description True when the admin changed section checks after picking a preset. */
+            customized: boolean;
+            /** @description IANA timezone printed on the PDF cover. */
+            timezone: string;
+            filename: string;
+            providerIds?: string[];
+            repoIds?: string[];
+        };
+        ReportCenterExportRecordResponseDto: {
+            /** @enum {boolean} */
+            ok: true;
+            /** Format: uuid */
+            activityEntryId: string;
+        };
         ActivityLogActorDto: {
             /** Format: uuid */
             userId: string;
@@ -8944,6 +8988,11 @@ export interface components {
              * @default false
              */
             force: boolean;
+            /**
+             * @description When true, each enqueued knowledge job clones the repository, builds the code graph, marks the index ready, and finishes with wiki tracks skipped. It does not write wiki pages and does not require an execution key. Omit or false to keep the full pipeline, including wiki. Distinct from skipLlm, which still writes a skeleton wiki. A job that is already queued or running keeps the options it was enqueued with.
+             * @default false
+             */
+            indexOnly: boolean;
         };
         CodeChatSyncIndexesResultDto: {
             enqueued: number;
@@ -10164,6 +10213,8 @@ export interface components {
         InsightsRecommendationsDateTo: string;
         /** @description AI provider ids (e.g. `cursor`, `copilot`). Empty/omitted = all configured providers. */
         InsightsRecommendationsProvider: string[];
+        /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+        InsightsAiUsageProvider: ("cursor" | "claude")[];
         /** @description Include contributors / AI rows not mapped to a team. */
         InsightsRecommendationsIncludeUnmapped: boolean;
         /** @description Include bot accounts in PR/CI stats. */
@@ -10552,6 +10603,8 @@ export type PutAgenticFoundationRepoScopeAppliedDto = components['schemas']['Put
 export type PutAgenticFoundationRepoScopeFailureDto = components['schemas']['PutAgenticFoundationRepoScopeFailureDto'];
 export type PutAgenticFoundationRepoScopeResponseDto = components['schemas']['PutAgenticFoundationRepoScopeResponseDto'];
 export type ActivityLogEventTypeDto = components['schemas']['ActivityLogEventTypeDto'];
+export type ReportCenterExportRecordBodyDto = components['schemas']['ReportCenterExportRecordBodyDto'];
+export type ReportCenterExportRecordResponseDto = components['schemas']['ReportCenterExportRecordResponseDto'];
 export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
 export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
 export type WorkspaceAbsenceDto = components['schemas']['WorkspaceAbsenceDto'];
@@ -10763,6 +10816,7 @@ export type ParameterInsightsRecommendationsTeams = components['parameters']['In
 export type ParameterInsightsRecommendationsDateFrom = components['parameters']['InsightsRecommendationsDateFrom'];
 export type ParameterInsightsRecommendationsDateTo = components['parameters']['InsightsRecommendationsDateTo'];
 export type ParameterInsightsRecommendationsProvider = components['parameters']['InsightsRecommendationsProvider'];
+export type ParameterInsightsAiUsageProvider = components['parameters']['InsightsAiUsageProvider'];
 export type ParameterInsightsRecommendationsIncludeUnmapped = components['parameters']['InsightsRecommendationsIncludeUnmapped'];
 export type ParameterInsightsRecommendationsIncludeBots = components['parameters']['InsightsRecommendationsIncludeBots'];
 export type ParameterPaginationLimit = components['parameters']['PaginationLimit'];
@@ -13300,6 +13354,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13356,6 +13412,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13412,6 +13470,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13468,6 +13528,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13524,6 +13586,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13644,6 +13708,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13700,6 +13766,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -13756,6 +13824,8 @@ export interface operations {
                 to?: components["parameters"]["InsightsProductivityTo"];
                 /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
                 department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description AI provider ids to include. Repeat the parameter or send comma-separated values. Empty or omitted includes all supported providers. */
+                provider?: components["parameters"]["InsightsAiUsageProvider"];
                 /** @description Team name filter; send `All teams` to include every team. */
                 team?: string;
                 /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
@@ -17158,6 +17228,61 @@ export interface operations {
             };
         };
     };
+    recordReportCenterExport: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ReportCenterExportRecordBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Export recorded */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReportCenterExportRecordResponseDto"];
+                };
+            };
+            /** @description Invalid 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"];
+                };
+            };
+            /** @description Activity log is not supported by this backend build */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     listWorkspaceActivity: {
         parameters: {
             query?: {
@@ -17169,7 +17294,7 @@ export interface operations {
                 order?: components["parameters"]["PaginationOrder"];
                 /** @description Server-side sort column (the activity "5 W's"). Combined with `order` (asc/desc). Defaults to `when` (occurredAt). `occurredAt`/`id` is always the tiebreaker. */
                 sort?: "when" | "who" | "what" | "why" | "where";
-                /** @description Coarse product-area grouping filter (#156). `integration` = GitHub + AI-tool key events; `agentic_foundation` = repos, readiness scans, fixes; `workspace_team` = members + HRIS; `productivity` = productivity ingest lifecycle events. Omit (or pass `all`) for every area. */
+                /** @description Coarse product-area grouping filter (#156). `integration` = GitHub + AI-tool key events; `agentic_foundation` = repos, readiness scans, fixes; `workspace_team` = members + HRIS + report exports; `productivity` = productivity ingest lifecycle events. Omit (or pass `all`) for every area. */
                 productArea?: "integration" | "agentic_foundation" | "workspace_team" | "productivity" | "all";
                 /** @description Filter to a specific event type. */
                 eventType?: components["schemas"]["ActivityLogEventTypeDto"];