@thinkai/tai-api-contract 2.161.0 → 2.163.0

package/src/generated/openapi.ts

@@ -2400,6 +2400,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/assessment-dictionary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the versioned assessment launch dictionary
+         * @description Returns approved assessment constants and explicit `unset` markers for unresolved decisions. Callers must fail closed instead of substituting values for an unset decision. Any workspace member may read it.
+         */
+        get: operations["getAssessmentDictionary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/aggregate-use-consent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read anonymized aggregate-use permission
+         * @description Returns whether ThinkAI may use this workspace's anonymized aggregate results in marketing and peer benchmarks. A workspace that never chose returns `unset`, which behaves as opted out (`effective: false`). The permission never covers company name, logo, quote, raw report, repository or person identity, or customer reference. Any workspace member may read it.
+         */
+        get: operations["getAggregateUseConsent"];
+        /**
+         * Set anonymized aggregate-use permission
+         * @description Workspace admins opt in or out. Every change writes one `workspace.aggregate_use.changed` activity-log row in the same transaction. Moving from `opt_in` to `opt_out` records a withdrawal and stops future extraction. Opt-in requires the current legal-approved notice version; while no notice is approved, opt-in returns `409 aggregate_use_notice_unapproved`. Opt-out is always accepted. A refusal does not change price, delivery, support, or assessment output.
+         */
+        put: operations["putAggregateUseConsent"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/report-center/exports": {
         parameters: {
             query?: never;
@@ -8705,7 +8749,110 @@ 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" | "report.exported";
+        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" | "workspace.aggregate_use.changed";
+        UnsetAssessmentDecisionDto: {
+            /** @enum {string} */
+            status: "unset";
+        };
+        /** @description Current legal-approved opt-in notice, or `unset` while opt-in is unavailable. */
+        AggregateUseNoticeStatusDto: {
+            /** @enum {string} */
+            status: "approved" | "unset";
+            /** @description Present only when `status` is `approved`. Send it back on opt-in. */
+            version?: string;
+        };
+        AggregateUseConsentDto: {
+            /**
+             * @description Saved choice. `unset` means the workspace never chose and is treated as opted out.
+             * @enum {string}
+             */
+            aggregateUse: "opt_in" | "opt_out" | "unset";
+            /** @description True only for `opt_in`. Benchmark and marketing extraction must check this. */
+            effective: boolean;
+            /** @description Notice version accepted with the current opt-in; null otherwise. */
+            noticeVersion: string | null;
+            /** @enum {string|null} */
+            source: "workspace_settings" | null;
+            /**
+             * Format: date-time
+             * @description When the current choice was saved; null when `unset`.
+             */
+            recordedAt: string | null;
+            recordedBy: {
+                /** Format: uuid */
+                userId: string;
+                displayName: string | null;
+            } | null;
+            /**
+             * Format: date-time
+             * @description Most recent opt-in withdrawal while the workspace remains opted out.
+             */
+            withdrawnAt: string | null;
+            currentNotice: components["schemas"]["AggregateUseNoticeStatusDto"];
+            /** @description Exact sentence the assessment PDF prints beside `recordedAt`. Opted-out and unset workspaces get the fixed refusal sentence. Opt-in returns the approved sentence for the accepted notice, or null if that notice is unknown, which blocks validation. */
+            reportSentence: string | null;
+        };
+        AggregateUseConsentPutDto: {
+            /** @enum {string} */
+            aggregateUse: "opt_in" | "opt_out";
+            /** @description Required for `opt_in` and must equal `currentNotice.version`. Ignored for `opt_out`. */
+            noticeVersion?: string | null;
+        };
+        AssessmentDictionaryDto: {
+            /** @enum {string} */
+            version: "2026-10-18.1";
+            /** @enum {integer} */
+            periodDays: 90;
+            /** @enum {integer} */
+            transitionDays: 14;
+            /** @enum {integer} */
+            repairDays: 14;
+            /** @enum {integer} */
+            secureLinkDays: 14;
+            /** @enum {integer} */
+            accessDaysAfterDelivery: 30;
+            /** @enum {integer} */
+            maxRepositories: 50;
+            /** @enum {integer} */
+            maxActiveEngineers: 500;
+            /** @enum {integer} */
+            dataCoverageRefreshCapDays: 90;
+            /** @enum {integer} */
+            aiUsageMaxRangeDays: 180;
+            /** @enum {integer} */
+            cursorChunkDays: 30;
+            /** @enum {integer} */
+            claudeChunkDays: 31;
+            watermarks: {
+                /** @enum {string} */
+                notValidated: "NOT VALIDATED";
+                /** @enum {string} */
+                syntheticSample: "SAMPLE · SYNTHETIC DATA";
+            };
+            offerIds: ("engineering_readiness_baseline" | "agentic_ai_roi")[];
+            sourceProviders: ("github" | "gitlab" | "bitbucket")[];
+            aiProviders: ("cursor" | "claude" | "copilot")[];
+            optionalProviders: {
+                roadmap: "jira"[];
+                incident: ("pagerduty" | "opsgenie" | "goalert" | "newrelic" | "prometheus" | "grafana")[];
+            };
+            selfManagedGit: {
+                /** @enum {string} */
+                status: "supported";
+                providers: ("gitlab_self_managed" | "bitbucket_data_center")[];
+            };
+            unresolved: {
+                baselinePrice: components["schemas"]["UnsetAssessmentDecisionDto"];
+                premiumPrice: components["schemas"]["UnsetAssessmentDecisionDto"];
+                currency: components["schemas"]["UnsetAssessmentDecisionDto"];
+                creditWindowDays: components["schemas"]["UnsetAssessmentDecisionDto"];
+                jiraLinkageMinimum: components["schemas"]["UnsetAssessmentDecisionDto"];
+                confounderRules: components["schemas"]["UnsetAssessmentDecisionDto"];
+                activeEngineerRule: components["schemas"]["UnsetAssessmentDecisionDto"];
+                workingDayCalendar: components["schemas"]["UnsetAssessmentDecisionDto"];
+                countryAllowList: components["schemas"]["UnsetAssessmentDecisionDto"];
+            };
+        };
         /** @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`). */
@@ -11244,6 +11391,11 @@ 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 UnsetAssessmentDecisionDto = components['schemas']['UnsetAssessmentDecisionDto'];
+export type AggregateUseNoticeStatusDto = components['schemas']['AggregateUseNoticeStatusDto'];
+export type AggregateUseConsentDto = components['schemas']['AggregateUseConsentDto'];
+export type AggregateUseConsentPutDto = components['schemas']['AggregateUseConsentPutDto'];
+export type AssessmentDictionaryDto = components['schemas']['AssessmentDictionaryDto'];
 export type ReportCenterExportRecordBodyDto = components['schemas']['ReportCenterExportRecordBodyDto'];
 export type ReportCenterExportRecordResponseDto = components['schemas']['ReportCenterExportRecordResponseDto'];
 export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
@@ -17870,6 +18022,135 @@ export interface operations {
             };
         };
     };
+    getAssessmentDictionary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current assessment dictionary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AssessmentDictionaryDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getAggregateUseConsent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current permission and the sentence reports must print */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AggregateUseConsentDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putAggregateUseConsent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AggregateUseConsentPutDto"];
+            };
+        };
+        responses: {
+            /** @description Saved permission */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AggregateUseConsentDto"];
+                };
+            };
+            /** @description Invalid body (`code`: `invalid_input`) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not a workspace admin (`code`: `workspace_admin_required`) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Opt-in refused because no notice is approved (`aggregate_use_notice_unapproved`) or the submitted notice version is not current (`aggregate_use_notice_stale`). */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     recordReportCenterExport: {
         parameters: {
             query?: never;
@@ -17936,7 +18217,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 + report exports; `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 + workspace settings; `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"];

package/src/index.ts

@@ -1111,7 +1111,12 @@ export interface ExportEventsResponseDto {
 }
 
 /** OpenAPI path and operation typings (generated from `openapi/openapi.yaml`). */
-export type { paths, operations, AgenticFoundationDashboardDto } from "./generated/openapi.js";
+export type {
+  paths,
+  operations,
+  AgenticFoundationDashboardDto,
+  AssessmentDictionaryDto,
+} from "./generated/openapi.js";
 
 // ---------------------------------------------------------------------------
 // Your AI Journey — /workspaces/:workspaceId/your-ai-journey/...