@thinkai/tai-api-contract 2.182.0 → 2.184.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -78,7 +78,7 @@ export interface paths {
78
78
  put?: never;
79
79
  /**
80
80
  * Evaluate assessment preflight from server-loaded evidence
81
- * @description Loads repository scope, readiness scan age, and window coverage for one workspace. Client fields for scope, scans, windows, and engineer counts are ignored, so an unscanned source cannot be marked fresh. The five-business-day clock uses Monday–Friday in America/New_York and is stored on the first passing result. A later blocker does not clear it. Active-engineer counts stay unloaded until stored activity can be counted.
81
+ * @description Loads repository scope, readiness scan age, and window coverage for one workspace. Client fields for scope, scans, windows, and engineer counts are ignored, so an unscanned source cannot be marked fresh. The five-business-day clock uses Monday–Friday in America/New_York and is stored on the first passing result. A later blocker does not clear it. The active-engineer count is loaded from stored commit authors and merged pull requests in the 90-day baseline window (bots and identities not on the org chart excluded). It stays unloaded until commit ingest covers the whole window for every non-archived repository.
82
82
  * **Authorization:** Bearer JWT required. Caller email must appear in `PLATFORM_ADMIN_EMAILS`.
83
83
  */
84
84
  post: operations["runLiveAssessmentPreflight"];
@@ -130,6 +130,56 @@ export interface paths {
130
130
  patch?: never;
131
131
  trace?: never;
132
132
  };
133
+ "/workspaces/{workspaceId}/assessment-manifest/validate": {
134
+ parameters: {
135
+ query?: never;
136
+ header?: never;
137
+ path?: never;
138
+ cookie?: never;
139
+ };
140
+ get?: never;
141
+ put?: never;
142
+ /**
143
+ * Validate this workspace's assessment manifest
144
+ * @description Runs the same fail-closed manifest check as `runAssessmentManifestValidation` for the workspace in the path. The server ignores `manifest.validation` and `manifest.watermark` from the client. `buyerDeliverable` is true only when the result is validated and `shareMode` is internal. An external share-safe result can be validated and is never the buyer file. Unset or exceeded tolerances fail. No numeric tolerance is assumed. GitLab and Bitbucket fixtures are not part of this operation.
145
+ * `workspaceId` and `expectedWorkspaceId` in the body must equal the path workspace. A body that names another workspace is rejected. Comparing two workspaces stays on `runAssessmentManifestValidation`.
146
+ * **Authorization:** Bearer JWT required. Caller must be a workspace admin, or a platform admin who is a member of this workspace. Members who are not workspace admins receive 403. Non-members of an existing workspace receive 403. Unknown workspaces receive 404.
147
+ */
148
+ post: operations["validateWorkspaceAssessmentManifest"];
149
+ delete?: never;
150
+ options?: never;
151
+ head?: never;
152
+ patch?: never;
153
+ trace?: never;
154
+ };
155
+ "/workspaces/{workspaceId}/assessment-manifest/build": {
156
+ parameters: {
157
+ query?: never;
158
+ header?: never;
159
+ path?: never;
160
+ cookie?: never;
161
+ };
162
+ get?: never;
163
+ put?: never;
164
+ /**
165
+ * Build and validate this workspace's assessment manifest from stored evidence
166
+ * @description The client sends only the offer, share mode, the render status of each selected section, and the matched-period ROI chapter it printed. The server fills scope, excluded repositories, windows, sources with freshness, consent, `expectedRepositoryIds`, `soldWindowComplete`, `premiumAiAssessable`, and tolerances from stored data, then runs the same fail-closed check as `validateWorkspaceAssessmentManifest`.
167
+ *
168
+ * Scope is the non-archived workspace repositories. Above 50 repositories or 500 active engineers fails (custom quote). For the premium offer, repositories without merged pull requests in both matched windows are listed in `excluded` and left out of scope. Baseline windows: `pre` is null, `post` is the 90 calendar days ending yesterday (America/New_York), and `transitionDays` is 0. Premium windows come from the confirmed rollout day. Freshness: source control 24 hours, AI usage 7 days, readiness scans 30 days. Aggregate-use consent is reported as stored; no row is `unset`.
169
+ *
170
+ * `premiumAiAssessable` needs fresh Cursor, Claude, or Copilot usage in the post window and complete matched-period evidence. A live ROI refusal for incomplete data blocks validation (`rollout_unset`, `window_missing`, `ship_weight_incomplete`, `active_engineers_unknown`, `confounder_inputs_missing`, `normalization_unset`, `output_unit_mismatch`). A refusal that is a legitimate result does not (`non_positive_output`, `confounder`, `missing_cost`, `non_usd_cost`, `cost_not_attributable`); the report prints "not assessable" with no figure. The premium `roi` tolerance is `unset` when the ROI section did not render or `roi` is missing, `exceeded` when the printed chapter differs from the server result (USD figures within the dictionary money tolerance), and `within` otherwise. Named-person sections always fail.
171
+ *
172
+ * Send `result.contentHash` with the PDF to `storeAssessmentReport`, which rebuilds the manifest and stores only when it is still a validated internal buyer file with the same hash.
173
+ *
174
+ * **Authorization:** Bearer JWT required. Caller must be a workspace admin, or a platform admin who is a member of this workspace. Members who are not workspace admins receive 403. Non-members of an existing workspace receive 403. Unknown workspaces receive 404.
175
+ */
176
+ post: operations["buildWorkspaceAssessmentManifest"];
177
+ delete?: never;
178
+ options?: never;
179
+ head?: never;
180
+ patch?: never;
181
+ trace?: never;
182
+ };
133
183
  "/admin/readiness/token-usage": {
134
184
  parameters: {
135
185
  query?: never;
@@ -2525,6 +2575,50 @@ export interface paths {
2525
2575
  patch?: never;
2526
2576
  trace?: never;
2527
2577
  };
2578
+ "/workspaces/{workspaceId}/assessment-rollout": {
2579
+ parameters: {
2580
+ query?: never;
2581
+ header?: never;
2582
+ path?: never;
2583
+ cookie?: never;
2584
+ };
2585
+ /**
2586
+ * Read the customer-confirmed assessment rollout day
2587
+ * @description Returns the AI rollout day the customer confirmed for the Agentic AI ROI assessment, interpreted at 00:00 America/New_York, plus who set it and when. This is the only rollout source for the matched pre and post windows. `rolloutDay` is null until an admin sets it. Any workspace member may read it.
2588
+ */
2589
+ get: operations["getWorkspaceAssessmentRollout"];
2590
+ /**
2591
+ * Set the customer-confirmed assessment rollout day
2592
+ * @description Workspace admins, or platform admins who are workspace members, set the rollout day. The day must be a real calendar date that has already started in America/New_York. Each save records the caller and time and writes one `workspace.assessment_rollout.changed` activity-log row.
2593
+ */
2594
+ put: operations["putWorkspaceAssessmentRollout"];
2595
+ post?: never;
2596
+ delete?: never;
2597
+ options?: never;
2598
+ head?: never;
2599
+ patch?: never;
2600
+ trace?: never;
2601
+ };
2602
+ "/workspaces/{workspaceId}/assessment-roi": {
2603
+ parameters: {
2604
+ query?: never;
2605
+ header?: never;
2606
+ path?: never;
2607
+ cookie?: never;
2608
+ };
2609
+ /**
2610
+ * Read the matched-period ROI from stored evidence
2611
+ * @description Derives the 90-day pre window, the 14-day transition, and the 90-day post window from the confirmed rollout day, then loads calendar-day coverage, merged pull request Ship Weight per window, and recorded USD AI spend for the post window. The figure is USD cost per incremental normalized Ship Weight (per active engineer and Mon–Fri America/New_York working day). Fails closed: `status` is `not_assessable` with a `reason` when a window is incomplete, cost is missing, non-USD, or not attributable by day, Ship Weight is unscored, active engineers are not countable, incremental output is not positive, or a confounder is flagged or cannot be checked. Cost is never estimated. Any workspace member may read it.
2612
+ */
2613
+ get: operations["getWorkspaceAssessmentRoi"];
2614
+ put?: never;
2615
+ post?: never;
2616
+ delete?: never;
2617
+ options?: never;
2618
+ head?: never;
2619
+ patch?: never;
2620
+ trace?: never;
2621
+ };
2528
2622
  "/workspaces/{workspaceId}/aggregate-use-consent": {
2529
2623
  parameters: {
2530
2624
  query?: never;
@@ -2569,6 +2663,130 @@ export interface paths {
2569
2663
  patch?: never;
2570
2664
  trace?: never;
2571
2665
  };
2666
+ "/workspaces/{workspaceId}/assessment-reports": {
2667
+ parameters: {
2668
+ query?: never;
2669
+ header?: never;
2670
+ path?: never;
2671
+ cookie?: never;
2672
+ };
2673
+ /**
2674
+ * List stored assessment reports and their secure links
2675
+ * @description Workspace admin (or platform admin who is a workspace member). Lists stored buyer PDFs (metadata only, never bytes) with every secure link grant. Link tokens and token hashes are never returned. A hidden report stays listed: `hidden_restorable` until `restoreUntil`, then `restore_window_ended`. The restore window is restore capability, not erasure. Responses carry `Cache-Control: no-store`.
2676
+ */
2677
+ get: operations["listAssessmentReports"];
2678
+ put?: never;
2679
+ /**
2680
+ * Store a validated buyer PDF for secure delivery
2681
+ * @description Workspace admin (or platform admin who is a workspace member). The client never supplies evidence: the server rebuilds the manifest from stored data with the same builder as `buildWorkspaceAssessmentManifest`, using only `build` (offer, share mode, section status, printed ROI), and stores the PDF only when `buyerDeliverable` is true (validated and internal) and the rebuilt `contentHash` equals the one sent. An external share-safe file is never stored here. The PDF is encrypted with AES-256-GCM and kept in Postgres with its sha256; it is limited to 10 MiB. Records `report.assessment_stored` without report content.
2682
+ */
2683
+ post: operations["storeAssessmentReport"];
2684
+ delete?: never;
2685
+ options?: never;
2686
+ head?: never;
2687
+ patch?: never;
2688
+ trace?: never;
2689
+ };
2690
+ "/workspaces/{workspaceId}/assessment-reports/{reportId}/links": {
2691
+ parameters: {
2692
+ query?: never;
2693
+ header?: never;
2694
+ path?: never;
2695
+ cookie?: never;
2696
+ };
2697
+ get?: never;
2698
+ put?: never;
2699
+ /**
2700
+ * Create a secure link and email it to a workspace member
2701
+ * @description Workspace admin (or platform admin who is a workspace member). Creates one link grant for a current workspace member and emails them the link only: generic text and `{siteUrl}/reports/secure?t=<opaque token>`. The email carries no PDF attachment, report name, metrics, repository, or person names. Only the sha256 of the token is stored and the token is never returned. Expiry defaults to 14 days and can be shorter. When SMTP is not configured the grant still stands and `email` says why it was skipped. Hidden reports cannot be shared (`409 report_hidden`).
2702
+ */
2703
+ post: operations["createAssessmentReportLink"];
2704
+ delete?: never;
2705
+ options?: never;
2706
+ head?: never;
2707
+ patch?: never;
2708
+ trace?: never;
2709
+ };
2710
+ "/workspaces/{workspaceId}/assessment-reports/{reportId}/links/{grantId}/revoke": {
2711
+ parameters: {
2712
+ query?: never;
2713
+ header?: never;
2714
+ path?: never;
2715
+ cookie?: never;
2716
+ };
2717
+ get?: never;
2718
+ put?: never;
2719
+ /**
2720
+ * Revoke a secure link
2721
+ * @description Workspace admin (or platform admin who is a workspace member). The link stops working immediately. Idempotent: revoking again keeps the first `revokedAt`. Revoking a link does not affect a file the recipient already downloaded. Records `report.assessment_link_revoked`.
2722
+ */
2723
+ post: operations["revokeAssessmentReportLink"];
2724
+ delete?: never;
2725
+ options?: never;
2726
+ head?: never;
2727
+ patch?: never;
2728
+ trace?: never;
2729
+ };
2730
+ "/workspaces/{workspaceId}/assessment-reports/{reportId}/hide": {
2731
+ parameters: {
2732
+ query?: never;
2733
+ header?: never;
2734
+ path?: never;
2735
+ cookie?: never;
2736
+ };
2737
+ get?: never;
2738
+ put?: never;
2739
+ /**
2740
+ * Hide a stored report
2741
+ * @description Workspace admin (or platform admin who is a workspace member). Same semantics as workspace delete: the report is hidden immediately and every link stops downloading. It can be restored for 30 days (`restoreUntil`). That window is restore capability, not erasure; no backup purge date is promised, and a file the buyer already downloaded stays with them. Idempotent. Records `report.assessment_hidden`.
2742
+ */
2743
+ post: operations["hideAssessmentReport"];
2744
+ delete?: never;
2745
+ options?: never;
2746
+ head?: never;
2747
+ patch?: never;
2748
+ trace?: never;
2749
+ };
2750
+ "/workspaces/{workspaceId}/assessment-reports/{reportId}/restore": {
2751
+ parameters: {
2752
+ query?: never;
2753
+ header?: never;
2754
+ path?: never;
2755
+ cookie?: never;
2756
+ };
2757
+ get?: never;
2758
+ put?: never;
2759
+ /**
2760
+ * Restore a hidden report within the 30-day window
2761
+ * @description Workspace admin (or platform admin who is a workspace member). Allowed only before `restoreUntil`; afterwards it fails with `409 restore_window_ended`. Links that were not revoked or expired work again after restore. Records `report.assessment_restored`.
2762
+ */
2763
+ post: operations["restoreAssessmentReport"];
2764
+ delete?: never;
2765
+ options?: never;
2766
+ head?: never;
2767
+ patch?: never;
2768
+ trace?: never;
2769
+ };
2770
+ "/assessment-reports/secure": {
2771
+ parameters: {
2772
+ query?: never;
2773
+ header?: never;
2774
+ path?: never;
2775
+ cookie?: never;
2776
+ };
2777
+ /**
2778
+ * Download a stored report through a secure link
2779
+ * @description Bearer JWT required. The caller must be the link recipient and a current member of the report's workspace. Access follows `decideReportAccess`: `leaked_token`, `removed_member`, and `wrong_workspace` answer 403; `expired` and `revoked` answer 410; `invalid_grant` answers 404. A hidden report answers `410 report_hidden`. Every response carries `Cache-Control: no-store`. Records `report.assessment_downloaded` without report content.
2780
+ */
2781
+ get: operations["downloadAssessmentReport"];
2782
+ put?: never;
2783
+ post?: never;
2784
+ delete?: never;
2785
+ options?: never;
2786
+ head?: never;
2787
+ patch?: never;
2788
+ trace?: never;
2789
+ };
2572
2790
  "/workspaces/{workspaceId}/activity": {
2573
2791
  parameters: {
2574
2792
  query?: never;
@@ -4287,7 +4505,7 @@ export interface paths {
4287
4505
  put?: never;
4288
4506
  /**
4289
4507
  * Import org chart from Supabase storage path
4290
- * @description Parse-only. Downloads the CSV at `storagePath` from the `org-charts` bucket and returns `persons` and `errors`. Does not persist to `spa_org_chart` or `org_chart`. The SPA derives teams client-side and saves the org structure via `POST /workspaces/{workspaceId}/org-chart`. Required columns: employee_id, name, email, title, department, team, manager_id, location. Optional: github_username (GitHub login for productivity ingest), bitbucket_nickname, bitbucket_uuid, alternate_emails (comma-separated alternate work emails for AI tool spend attribution). Saving the SPA snapshot also materializes a scoring `org_chart` tree for team/person metrics when import members are present. Parse-only responses may include duplicateEmailWarnings, identityEmailPreview (cross-check against connected AI tool seat rosters), and importWarnings when roster preview is unavailable.
4508
+ * @description Parse-only. Downloads the CSV at `storagePath` from the `org-charts` bucket and returns `persons` and `errors`. Does not persist to `spa_org_chart` or `org_chart`. The SPA derives teams client-side and saves the org structure via `POST /workspaces/{workspaceId}/org-chart`. Required columns: employee_id, name, email, title, department, team, manager_id, location. Optional: github_username (GitHub login for productivity ingest), bitbucket_nickname, bitbucket_uuid, gitlab_username (GitLab.com or self-managed username), alternate_emails (comma-separated alternate work emails for AI tool spend attribution). Saving the SPA snapshot also materializes a scoring `org_chart` tree for team/person metrics when import members are present. Parse-only responses may include duplicateEmailWarnings, identityEmailPreview (cross-check against connected AI tool seat rosters), and importWarnings when roster preview is unavailable.
4291
4509
  */
4292
4510
  post: operations["postOrgChartImport"];
4293
4511
  delete?: never;
@@ -4744,6 +4962,46 @@ export interface paths {
4744
4962
  patch?: never;
4745
4963
  trace?: never;
4746
4964
  };
4965
+ "/workspaces/{workspaceId}/sources/discover": {
4966
+ parameters: {
4967
+ query?: never;
4968
+ header?: never;
4969
+ path?: never;
4970
+ cookie?: never;
4971
+ };
4972
+ get?: never;
4973
+ put?: never;
4974
+ /**
4975
+ * List repositories a GitLab or Bitbucket source can read (does not persist)
4976
+ * @description Lists projects (GitLab.com, self-managed GitLab) or repositories (Bitbucket Cloud, Bitbucket Data Center) for repository selection. Nothing is stored. Self-managed and Data Center `baseUrl` must be `https`, public, and without credentials; private, loopback, and link-local hosts are rejected before any request. `env:` token references are rejected for self-hosted providers and never resolved from the request for cloud providers. A blank or `***` token reuses the stored source with the same provider, host, and account, and requires the editor or admin role. The list covers the whole account (group or workspace/project key), not only `projects`/`repos`. `repoCap` is the standard repository cap (50); ingest refuses to auto-select more than that. Tokens are never returned.
4977
+ */
4978
+ post: operations["postWorkspaceVcsRepoDiscovery"];
4979
+ delete?: never;
4980
+ options?: never;
4981
+ head?: never;
4982
+ patch?: never;
4983
+ trace?: never;
4984
+ };
4985
+ "/workspaces/{workspaceId}/vcs-provider-coverage": {
4986
+ parameters: {
4987
+ query?: never;
4988
+ header?: never;
4989
+ path?: never;
4990
+ cookie?: never;
4991
+ };
4992
+ /**
4993
+ * GitLab and Bitbucket Data Coverage freshness (server-computed)
4994
+ * @description One row per configured GitLab or Bitbucket source. Freshness is computed on the server from batch-written sync rows and succeeded readiness runs; no request field can mark a row fresh. Git is fresh when the last complete ingest finished within `gitFreshnessHours` (24) and no error was recorded after it. A readiness scan is fresh within `readinessScanFreshnessDays` (30, America/New_York calendar days); `scansFresh` requires every in-scope repository to have a fresh scan. A source with an invalid base URL or missing account is `misconfigured`. Requires workspace membership.
4995
+ */
4996
+ get: operations["getWorkspaceVcsProviderCoverage"];
4997
+ put?: never;
4998
+ post?: never;
4999
+ delete?: never;
5000
+ options?: never;
5001
+ head?: never;
5002
+ patch?: never;
5003
+ trace?: never;
5004
+ };
4747
5005
  "/workspaces/{workspaceId}/ingest/productivity/repos/{slug}/retry": {
4748
5006
  parameters: {
4749
5007
  query?: never;
@@ -5068,6 +5326,81 @@ export interface paths {
5068
5326
  export type webhooks = Record<string, never>;
5069
5327
  export interface components {
5070
5328
  schemas: {
5329
+ /** @description Body of runAssessmentManifestValidation; buildWorkspaceAssessmentManifest returns the server-built object as `validation`. */
5330
+ AssessmentManifestValidationBodyDto: {
5331
+ manifest: {
5332
+ /** @enum {string} */
5333
+ offerId: "engineering_readiness_baseline" | "agentic_ai_roi";
5334
+ dictionaryVersion: string;
5335
+ /** @enum {string} */
5336
+ validation: "validated" | "not_validated";
5337
+ /** @enum {string} */
5338
+ shareMode: "internal" | "external";
5339
+ /** @enum {string|null} */
5340
+ watermark: "NOT VALIDATED" | "SAMPLE · SYNTHETIC DATA" | null;
5341
+ scope: {
5342
+ repositories: {
5343
+ id: string;
5344
+ name: string;
5345
+ }[];
5346
+ excluded: {
5347
+ id: string;
5348
+ name: string;
5349
+ reason: string;
5350
+ }[];
5351
+ };
5352
+ windows: {
5353
+ pre: {
5354
+ start: string;
5355
+ end: string;
5356
+ } | null;
5357
+ post: {
5358
+ start: string;
5359
+ end: string;
5360
+ } | null;
5361
+ transitionDays: number;
5362
+ };
5363
+ sources: {
5364
+ provider: string;
5365
+ status: string;
5366
+ freshAt: string | null;
5367
+ }[];
5368
+ consent: {
5369
+ /** @enum {string} */
5370
+ aggregateUse: "opt_in" | "opt_out" | "unset";
5371
+ recordedAt: string | null;
5372
+ };
5373
+ sections: {
5374
+ id: string;
5375
+ /** @enum {string} */
5376
+ status: "ok" | "failed" | "omitted";
5377
+ reason?: string;
5378
+ }[];
5379
+ };
5380
+ workspaceId: string;
5381
+ expectedWorkspaceId: string;
5382
+ expectedRepositoryIds: string[];
5383
+ soldWindowComplete: boolean;
5384
+ premiumAiAssessable: boolean;
5385
+ namedPersonSectionIds: string[];
5386
+ tolerances: {
5387
+ id: string;
5388
+ /** @enum {string} */
5389
+ status: "unset" | "exceeded" | "within";
5390
+ }[];
5391
+ };
5392
+ AssessmentManifestValidationResultDto: {
5393
+ buyerDeliverable: boolean;
5394
+ /** @enum {string} */
5395
+ validation: "validated" | "not_validated";
5396
+ /** @enum {string|null} */
5397
+ watermark: "NOT VALIDATED" | null;
5398
+ reasons: {
5399
+ code: string;
5400
+ message: string;
5401
+ }[];
5402
+ contentHash: string;
5403
+ };
5071
5404
  TeamsInstallUrlDto: {
5072
5405
  /** Format: uri */
5073
5406
  url: string;
@@ -5233,6 +5566,8 @@ export interface components {
5233
5566
  bitbucketNickname?: string;
5234
5567
  /** @description Bitbucket account UUID (e.g. "{aeefb6b0-...}") to attribute merged PRs and reviews to this person in productivity ingest. Preferred over bitbucketNickname — Bitbucket PR payloads expose a stable uuid but not nickname. Resolves to the same person_id (email) as githubUsername. */
5235
5568
  bitbucketUuid?: string;
5569
+ /** @description GitLab username (no @; GitLab.com or self-managed) to map merged merge requests and commits to this person in productivity ingest and the assessment active-engineer count. Stored lowercased. Resolves to the same person_id (email) as githubUsername. */
5570
+ gitlabUsername?: string;
5236
5571
  /** @description Optional comma-separated work emails that map to the same person for AI tool spend/usage (mirrors multi-login github_username). Primary email remains canonical person_id. */
5237
5572
  alternateEmails?: string;
5238
5573
  };
@@ -5263,6 +5598,7 @@ export interface components {
5263
5598
  githubUsername?: string;
5264
5599
  bitbucketNickname?: string;
5265
5600
  bitbucketUuid?: string;
5601
+ gitlabUsername?: string;
5266
5602
  /** @description Comma-separated alternate work emails for AI tool attribution. */
5267
5603
  alternateEmails?: string;
5268
5604
  };
@@ -5472,6 +5808,38 @@ export interface components {
5472
5808
  /** @description New Relic user name when known from the last successful verify. */
5473
5809
  userName?: string;
5474
5810
  };
5811
+ /** @description Datadog monitoring source for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. Requires an API key, an Application key, and a site host suffix (US1/US3/US5/EU/AP1). Raw keys are write-only. */
5812
+ DatadogSourceDto: {
5813
+ /** @enum {string} */
5814
+ type: "datadog";
5815
+ /** @description Datadog API key (write-only on PUT; encrypted at rest). */
5816
+ apiKey: string;
5817
+ /** @description Datadog Application key (write-only on PUT; encrypted at rest). */
5818
+ appKey: string;
5819
+ /**
5820
+ * @description Datadog site host suffix. Maps to API host `api.{site}` (US1 `datadoghq.com`, US3 `us3.datadoghq.com`, US5 `us5.datadoghq.com`, EU `datadoghq.eu`, AP1 `ap1.datadoghq.com`). Gov/custom sites are out of scope.
5821
+ * @enum {string}
5822
+ */
5823
+ site: "datadoghq.com" | "us3.datadoghq.com" | "us5.datadoghq.com" | "datadoghq.eu" | "ap1.datadoghq.com";
5824
+ /** @description Optional org display name returned from a successful connection test. */
5825
+ orgName?: string;
5826
+ };
5827
+ /** @description Redacted Datadog source returned by `GET /workspaces/{workspaceId}/config`. Raw `apiKey` and `appKey` are never returned. */
5828
+ DatadogSourceConfigDto: {
5829
+ /** @enum {string} */
5830
+ type: "datadog";
5831
+ /** @description Whether a Datadog API key is stored for this workspace. */
5832
+ hasApiKey: boolean;
5833
+ /** @description Whether a Datadog Application key is stored for this workspace. */
5834
+ hasAppKey: boolean;
5835
+ /**
5836
+ * @description Configured Datadog site host suffix.
5837
+ * @enum {string}
5838
+ */
5839
+ site: "datadoghq.com" | "us3.datadoghq.com" | "us5.datadoghq.com" | "datadoghq.eu" | "ap1.datadoghq.com";
5840
+ /** @description Org display name when known from the last successful verify. */
5841
+ orgName?: string;
5842
+ };
5475
5843
  /** @description Prometheus / Alertmanager monitoring source for workspace sources PUT and connection test. Provide at least one URL; authentication is optional. */
5476
5844
  PrometheusSourceDto: {
5477
5845
  /** @enum {string} */
@@ -5721,7 +6089,7 @@ export interface components {
5721
6089
  topics?: components["schemas"]["CodeWikiGuidanceTopicDto"][];
5722
6090
  };
5723
6091
  WorkspaceConfigDto: {
5724
- sources: (components["schemas"]["CursorSourceConfigDto"] | components["schemas"]["ClaudeSourceConfigDto"] | components["schemas"]["CodeIntelligenceSourceConfigDto"] | components["schemas"]["NewRelicSourceConfigDto"] | components["schemas"]["PrometheusSourceConfigDto"] | components["schemas"]["GrafanaSourceConfigDto"] | components["schemas"]["SonarQubeSourceConfigDto"] | components["schemas"]["PagerDutySourceConfigDto"] | components["schemas"]["JiraSourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
6092
+ sources: (components["schemas"]["CursorSourceConfigDto"] | components["schemas"]["ClaudeSourceConfigDto"] | components["schemas"]["CodeIntelligenceSourceConfigDto"] | components["schemas"]["NewRelicSourceConfigDto"] | components["schemas"]["DatadogSourceConfigDto"] | components["schemas"]["PrometheusSourceConfigDto"] | components["schemas"]["GrafanaSourceConfigDto"] | components["schemas"]["SonarQubeSourceConfigDto"] | components["schemas"]["PagerDutySourceConfigDto"] | components["schemas"]["JiraSourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
5725
6093
  orgChart?: components["schemas"]["ScoringOrgChartDto"] | null;
5726
6094
  /** @enum {string|null} */
5727
6095
  region?: "us" | "eu" | "me" | null;
@@ -5844,7 +6212,7 @@ export interface components {
5844
6212
  accountName?: string;
5845
6213
  /** @description Present for New Relic or Jira verify success — resolved account ID. */
5846
6214
  accountId?: string;
5847
- /** @description Present for Grafana verify success — resolved organization name. */
6215
+ /** @description Present for Grafana or Datadog verify success — resolved organization name. */
5848
6216
  orgName?: string;
5849
6217
  /** @description Present for Prometheus verify success — Alertmanager cluster name. */
5850
6218
  clusterName?: string;
@@ -7792,10 +8160,88 @@ export interface components {
7792
8160
  * @enum {string}
7793
8161
  */
7794
8162
  ReadinessDimensionId: "ai-agent-readiness" | "token-efficiency" | "repo-hygiene" | "stack-quality" | "tests-qa" | "observability" | "api-contracts" | "platform-governance" | "delivery";
8163
+ /**
8164
+ * @description `bitbucket_server` is Bitbucket Data Center. Self-hosted providers (`gitlab_self_managed`, `bitbucket_server`) always carry `hostBaseUrl`.
8165
+ * @enum {string}
8166
+ */
8167
+ ExternalVcsProviderDto: "gitlab_cloud" | "gitlab_self_managed" | "bitbucket_cloud" | "bitbucket_server";
8168
+ /** @description GitLab or Bitbucket tenant source entry. GitLab: optional `group` (full path) and `projects` (`group/sub/project`). Bitbucket: `workspace` (Cloud workspace or Data Center project key) and optional `repos` (repository slugs). `deployment` selects self-hosted; it then requires `baseUrl`. */
8169
+ GitVcsSourceDto: {
8170
+ /** @enum {string} */
8171
+ type: "gitlab" | "bitbucket";
8172
+ /** @enum {string} */
8173
+ deployment?: "cloud" | "self_managed" | "data_center";
8174
+ baseUrl?: string;
8175
+ group?: string;
8176
+ projects?: string[];
8177
+ workspace?: string;
8178
+ repos?: string[];
8179
+ /** @description Personal / project / HTTP access token, or `***` to reuse the stored token. */
8180
+ token?: string;
8181
+ } & {
8182
+ [key: string]: unknown;
8183
+ };
8184
+ VcsDiscoveredRepoDto: {
8185
+ /** @description `group/sub/project` (GitLab) or `workspace/repo` / `PROJECT/repo` (Bitbucket) */
8186
+ slug: string;
8187
+ name: string;
8188
+ defaultBranch: string | null;
8189
+ webUrl: string | null;
8190
+ };
8191
+ VcsRepoDiscoveryResponseDto: {
8192
+ provider: components["schemas"]["ExternalVcsProviderDto"];
8193
+ hostBaseUrl: string | null;
8194
+ /** @description GitLab group path (empty = token membership), Bitbucket workspace, or project key */
8195
+ account: string;
8196
+ /** @description True when the provider page limit was reached; the list is incomplete. */
8197
+ truncated: boolean;
8198
+ repoCap: number;
8199
+ repositories: components["schemas"]["VcsDiscoveredRepoDto"][];
8200
+ };
8201
+ VcsProviderCoverageRowDto: {
8202
+ provider: components["schemas"]["ExternalVcsProviderDto"];
8203
+ hostBaseUrl: string | null;
8204
+ account: string;
8205
+ selfHosted: boolean;
8206
+ /** @enum {string} */
8207
+ state: "fresh" | "stale" | "never_synced" | "error" | "misconfigured";
8208
+ /** @description Server-computed; true only when `state` is `fresh`. */
8209
+ isFresh: boolean;
8210
+ /** Format: date-time */
8211
+ lastIngestSuccessAt: string | null;
8212
+ lastErrorKind: string | null;
8213
+ /** Format: date-time */
8214
+ lastDiscoveryAt: string | null;
8215
+ discoveredRepoCount: number | null;
8216
+ /** @description Milliseconds past the Git freshness limit when `state` is `stale`. */
8217
+ staleForMs: number | null;
8218
+ /** @description In-scope repositories stored for this source. */
8219
+ repoCount: number;
8220
+ scannedRepoCount: number;
8221
+ freshScanRepoCount: number;
8222
+ scansFresh: boolean;
8223
+ /**
8224
+ * Format: date-time
8225
+ * @description Earliest merge time reached by the assessment merged-request history backfill for this source; null when no backfill window has been written.
8226
+ */
8227
+ mergedHistorySince: string | null;
8228
+ /**
8229
+ * Format: date-time
8230
+ * @description Instant from which every in-scope repository of this source has contiguous default-branch commit-author coverage (latest per-repo coverage start); null when any repository has no coverage.
8231
+ */
8232
+ commitHistorySince: string | null;
8233
+ };
8234
+ VcsProviderCoverageDto: {
8235
+ /** Format: date-time */
8236
+ generatedAt: string;
8237
+ gitFreshnessHours: number;
8238
+ readinessScanFreshnessDays: number;
8239
+ sources: components["schemas"]["VcsProviderCoverageRowDto"][];
8240
+ };
7795
8241
  RepoProviderDto: {
7796
8242
  /** @enum {string} */
7797
- kind: "github" | "bitbucket_cloud" | "bitbucket_server";
7798
- /** @description owner/repo (GitHub), workspace/repo_slug (Bitbucket Cloud), or PROJECT_KEY/repo_slug (Bitbucket Server) */
8243
+ kind: "github" | "bitbucket_cloud" | "bitbucket_server" | "gitlab_cloud" | "gitlab_self_managed";
8244
+ /** @description owner/repo (GitHub), workspace/repo_slug (Bitbucket Cloud), PROJECT_KEY/repo_slug (Bitbucket Server / Data Center), or group/sub/project (GitLab) */
7799
8245
  slug: string;
7800
8246
  /**
7801
8247
  * Format: uri
@@ -7807,7 +8253,7 @@ export interface components {
7807
8253
  externalId?: string | null;
7808
8254
  /**
7809
8255
  * Format: uri
7810
- * @description Required for bitbucket_server (self-hosted); null for cloud providers
8256
+ * @description Required for bitbucket_server and gitlab_self_managed (self-hosted); null for cloud providers
7811
8257
  */
7812
8258
  hostBaseUrl?: string | null;
7813
8259
  };
@@ -9156,11 +9602,7 @@ export interface components {
9156
9602
  * @description Type of workspace lifecycle event.
9157
9603
  * @enum {string}
9158
9604
  */
9159
- ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "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";
9160
- UnsetAssessmentDecisionDto: {
9161
- /** @enum {string} */
9162
- status: "unset";
9163
- };
9605
+ ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "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" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
9164
9606
  /** @description Current legal-approved opt-in notice, or `unset` while opt-in is unavailable. */
9165
9607
  AggregateUseNoticeStatusDto: {
9166
9608
  /** @enum {string} */
@@ -9168,6 +9610,122 @@ export interface components {
9168
9610
  /** @description Present only when `status` is `approved`. Send it back on opt-in. */
9169
9611
  version?: string;
9170
9612
  };
9613
+ /**
9614
+ * @description Confounder-relevant named event from the assessment dictionary.
9615
+ * @enum {string}
9616
+ */
9617
+ AssessmentNamedEventDto: "major_release" | "migration" | "acquisition" | "policy_change";
9618
+ AssessmentRolloutDto: {
9619
+ /**
9620
+ * Format: date
9621
+ * @description Confirmed rollout day (`YYYY-MM-DD`); null until set.
9622
+ */
9623
+ rolloutDay: string | null;
9624
+ /** @enum {string} */
9625
+ timezone: "America/New_York";
9626
+ /** @enum {string} */
9627
+ boundary: "midnight";
9628
+ /**
9629
+ * Format: date-time
9630
+ * @description UTC instant of 00:00 America/New_York on `rolloutDay`.
9631
+ */
9632
+ startsAt: string | null;
9633
+ setBy: {
9634
+ /** Format: uuid */
9635
+ userId: string;
9636
+ displayName: string | null;
9637
+ } | null;
9638
+ /** Format: date-time */
9639
+ setAt: string | null;
9640
+ /** @description Named events confirmed during either matched window. Null means the customer or operator has not confirmed yet, so the ROI confounder check reports `confounder_inputs_missing`. An empty array confirms none occurred. */
9641
+ namedEvents: components["schemas"]["AssessmentNamedEventDto"][] | null;
9642
+ namedEventsConfirmedBy: {
9643
+ /** Format: uuid */
9644
+ userId: string;
9645
+ displayName: string | null;
9646
+ } | null;
9647
+ /** Format: date-time */
9648
+ namedEventsConfirmedAt: string | null;
9649
+ };
9650
+ AssessmentRolloutPutDto: {
9651
+ /**
9652
+ * Format: date
9653
+ * @description Real calendar date, not after today in America/New_York.
9654
+ */
9655
+ rolloutDay: string;
9656
+ /** @description Omit to leave the stored named-event confirmation unchanged. Send an empty array to confirm no named event occurred during either matched window, or the events that did. */
9657
+ namedEvents?: components["schemas"]["AssessmentNamedEventDto"][];
9658
+ };
9659
+ /**
9660
+ * @description Why the matched-period ROI is not assessable. `cost_not_attributable` means a billing-cycle bill (GitHub Copilot) overlaps the post window and cannot be split by day. `active_engineers_unknown` means stored identities cannot yet be counted. `confounder_inputs_missing` means a named-event, headcount, or repository-scope check has no stored input.
9661
+ * @enum {string}
9662
+ */
9663
+ AssessmentRoiReasonDto: "rollout_unset" | "window_missing" | "missing_cost" | "non_usd_cost" | "cost_not_attributable" | "ship_weight_incomplete" | "active_engineers_unknown" | "non_positive_output" | "normalization_unset" | "confounder" | "confounder_inputs_missing" | "output_unit_mismatch";
9664
+ AssessmentRoiDayRangeDto: {
9665
+ /** Format: date */
9666
+ from: string;
9667
+ /** Format: date */
9668
+ to: string;
9669
+ };
9670
+ AssessmentRoiWindowDto: {
9671
+ /** Format: date */
9672
+ from: string;
9673
+ /** Format: date */
9674
+ to: string;
9675
+ /** @description Calendar days in the window (90). */
9676
+ requiredDays: number;
9677
+ /** @description Calendar days with stored evidence. */
9678
+ coveredDays: number;
9679
+ /** @description Every calendar day is covered and the window ended before today. */
9680
+ complete: boolean;
9681
+ /** @description Monday–Friday days in America/New_York. No holidays. */
9682
+ workingDays: number;
9683
+ activeEngineers: number | null;
9684
+ mergedPullRequests: number;
9685
+ /** @description Sum of stored Ship Weight for unique merged pull requests; null if any is unscored. */
9686
+ shipWeight: number | null;
9687
+ /** @description Ship Weight per active engineer per working day. */
9688
+ normalizedShipWeight: number | null;
9689
+ };
9690
+ AssessmentRoiDto: {
9691
+ dictionaryVersion: string;
9692
+ /** Format: date */
9693
+ rolloutDay: string | null;
9694
+ rolloutBoundary: {
9695
+ /** @enum {string} */
9696
+ timezone: "America/New_York";
9697
+ /** @enum {string} */
9698
+ boundary: "midnight";
9699
+ /** Format: date-time */
9700
+ startsAt: string | null;
9701
+ };
9702
+ windows: {
9703
+ pre: components["schemas"]["AssessmentRoiWindowDto"] | null;
9704
+ transition: components["schemas"]["AssessmentRoiDayRangeDto"] | null;
9705
+ post: components["schemas"]["AssessmentRoiWindowDto"] | null;
9706
+ };
9707
+ /** @description Recorded daily AI spend inside the post window. Never estimated. */
9708
+ cost: {
9709
+ amountUsd: number | null;
9710
+ /** @enum {string|null} */
9711
+ currency: "USD" | null;
9712
+ providers: string[];
9713
+ };
9714
+ confounders: {
9715
+ /** @description Null when no named-event input is stored. */
9716
+ namedEvent: boolean | null;
9717
+ headcountChangeRatio: number | null;
9718
+ /** @description Repositories with merged pull requests in only one window, over pre-window repositories. */
9719
+ repositoryScopeChangeRatio: number | null;
9720
+ };
9721
+ /** @enum {string} */
9722
+ status: "assessable" | "not_assessable";
9723
+ reason: components["schemas"]["AssessmentRoiReasonDto"] | null;
9724
+ incrementalNormalizedShipWeight: number | null;
9725
+ costPerIncrementalShipWeightUsd: number | null;
9726
+ /** @description Separate correlation. Never the sold ROI figure. */
9727
+ costPerMergedPullRequestUsd: number | null;
9728
+ };
9171
9729
  AggregateUseConsentDto: {
9172
9730
  /**
9173
9731
  * @description Saved choice. `unset` means the workspace never chose and is treated as opted out.
@@ -9207,7 +9765,7 @@ export interface components {
9207
9765
  };
9208
9766
  AssessmentDictionaryDto: {
9209
9767
  /** @enum {string} */
9210
- version: "2026-10-20.1";
9768
+ version: "2026-10-24.1";
9211
9769
  /** @enum {integer} */
9212
9770
  periodDays: 90;
9213
9771
  /** @enum {integer} */
@@ -9285,8 +9843,22 @@ export interface components {
9285
9843
  costAssessableCurrency: "USD";
9286
9844
  };
9287
9845
  unresolved: {
9288
- baselinePrice: components["schemas"]["UnsetAssessmentDecisionDto"];
9289
- premiumPrice: components["schemas"]["UnsetAssessmentDecisionDto"];
9846
+ baselinePrice: {
9847
+ /** @enum {string} */
9848
+ status: "set";
9849
+ /** @enum {integer} */
9850
+ amountUsd: 4999;
9851
+ /** @enum {string} */
9852
+ taxes: "extra";
9853
+ };
9854
+ premiumPrice: {
9855
+ /** @enum {string} */
9856
+ status: "set";
9857
+ /** @enum {integer} */
9858
+ amountUsd: 9999;
9859
+ /** @enum {string} */
9860
+ taxes: "extra";
9861
+ };
9290
9862
  currency: {
9291
9863
  /** @enum {string} */
9292
9864
  status: "set";
@@ -9334,7 +9906,14 @@ export interface components {
9334
9906
  /** @enum {string} */
9335
9907
  holidays: "none";
9336
9908
  };
9337
- countryAllowList: components["schemas"]["UnsetAssessmentDecisionDto"];
9909
+ /** @description Owner decision without counsel acceptance; `counselAccepted` stays false. */
9910
+ countryAllowList: {
9911
+ /** @enum {string} */
9912
+ status: "set";
9913
+ countries: ("US" | "BH" | "KW" | "OM" | "QA" | "SA" | "AE")[];
9914
+ /** @enum {boolean} */
9915
+ counselAccepted: false;
9916
+ };
9338
9917
  };
9339
9918
  };
9340
9919
  /** @description Metadata for a successful Report Center PDF download. Secret-free; no table payloads. Recorded as `report.exported` on the workspace activity log. */
@@ -9361,6 +9940,126 @@ export interface components {
9361
9940
  providerIds?: string[];
9362
9941
  repoIds?: string[];
9363
9942
  };
9943
+ StoreAssessmentReportBodyDto: {
9944
+ /** @description The buyer PDF, base64-encoded. Must start with `%PDF-`; at most 10 MiB decoded. */
9945
+ pdfBase64: string;
9946
+ build: components["schemas"]["BuildAssessmentManifestBodyDto"];
9947
+ /** @description `result.contentHash` from the `buildWorkspaceAssessmentManifest` call the PDF was rendered from. The server rebuilds the manifest and rejects a different hash. */
9948
+ contentHash: string;
9949
+ };
9950
+ BuildAssessmentManifestBodyDto: {
9951
+ /** @enum {string} */
9952
+ offerId: "engineering_readiness_baseline" | "agentic_ai_roi";
9953
+ /** @enum {string} */
9954
+ shareMode: "internal" | "external";
9955
+ /** @description Every selected section with its render status. Ids are unique. */
9956
+ sections: {
9957
+ id: string;
9958
+ /** @enum {string} */
9959
+ status: "ok" | "failed" | "omitted";
9960
+ reason?: string;
9961
+ }[];
9962
+ /** @description The matched-period ROI chapter as printed, copied from the `getWorkspaceAssessmentRoi` result it rendered. Null or omitted when the chapter did not print one. */
9963
+ roi?: components["schemas"]["PrintedAssessmentRoiDto"] | null;
9964
+ };
9965
+ PrintedAssessmentRoiDto: {
9966
+ /** @enum {string} */
9967
+ status: "assessable" | "not_assessable";
9968
+ reason: string | null;
9969
+ incrementalNormalizedShipWeight: number | null;
9970
+ costPerIncrementalShipWeightUsd: number | null;
9971
+ costPerMergedPullRequestUsd: number | null;
9972
+ };
9973
+ BuildAssessmentManifestResponseDto: {
9974
+ validation: components["schemas"]["AssessmentManifestValidationBodyDto"];
9975
+ result: components["schemas"]["AssessmentManifestValidationResultDto"];
9976
+ };
9977
+ StoreAssessmentReportRejectedDto: {
9978
+ error: string;
9979
+ /** @enum {string} */
9980
+ code: "not_buyer_deliverable" | "manifest_changed";
9981
+ /** @enum {string} */
9982
+ validation?: "validated" | "not_validated";
9983
+ reasons?: {
9984
+ code: string;
9985
+ message: string;
9986
+ }[];
9987
+ };
9988
+ AssessmentReportLinkDto: {
9989
+ /** Format: uuid */
9990
+ id: string;
9991
+ /** Format: uuid */
9992
+ reportId: string;
9993
+ /** Format: uuid */
9994
+ recipientUserId: string;
9995
+ /** @description Null when the recipient is no longer a workspace member. */
9996
+ recipientEmail: string | null;
9997
+ recipientName: string | null;
9998
+ /** Format: date-time */
9999
+ expiresAt: string;
10000
+ /** Format: date-time */
10001
+ revokedAt: string | null;
10002
+ /** Format: date-time */
10003
+ createdAt: string;
10004
+ /** Format: date-time */
10005
+ lastAccessedAt: string | null;
10006
+ /** @enum {string} */
10007
+ status: "active" | "expired" | "revoked";
10008
+ };
10009
+ AssessmentReportDto: {
10010
+ /** Format: uuid */
10011
+ id: string;
10012
+ /** @enum {string} */
10013
+ offerId: "engineering_readiness_baseline" | "agentic_ai_roi";
10014
+ sizeBytes: number;
10015
+ /** @description sha256 of the plaintext PDF. */
10016
+ sha256: string;
10017
+ /** @description `contentHash` of the validated manifest. */
10018
+ manifestHash: string;
10019
+ /** Format: date-time */
10020
+ createdAt: string;
10021
+ /** Format: uuid */
10022
+ createdBy: string | null;
10023
+ /** Format: date-time */
10024
+ hiddenAt: string | null;
10025
+ /**
10026
+ * Format: date-time
10027
+ * @description End of the restore window. Not an erasure or backup purge date.
10028
+ */
10029
+ restoreUntil: string | null;
10030
+ /** @enum {string} */
10031
+ status: "available" | "hidden_restorable" | "restore_window_ended";
10032
+ links: components["schemas"]["AssessmentReportLinkDto"][];
10033
+ };
10034
+ AssessmentReportListDto: {
10035
+ /** @enum {integer} */
10036
+ restoreWindowDays: 30;
10037
+ /**
10038
+ * @description Default and maximum secure link lifetime in days.
10039
+ * @enum {integer}
10040
+ */
10041
+ secureLinkDays: 14;
10042
+ reports: components["schemas"]["AssessmentReportDto"][];
10043
+ };
10044
+ CreateAssessmentReportLinkBodyDto: {
10045
+ /**
10046
+ * Format: uuid
10047
+ * @description A current workspace member (`TeamMemberDto.id`).
10048
+ */
10049
+ recipientUserId: string;
10050
+ /** @default 14 */
10051
+ expiresInDays: number;
10052
+ };
10053
+ CreateAssessmentReportLinkResponseDto: {
10054
+ link: components["schemas"]["AssessmentReportLinkDto"];
10055
+ /** @enum {string} */
10056
+ email: "sent" | "skipped_missing_smtp" | "skipped_missing_base_url" | "failed";
10057
+ };
10058
+ AssessmentReportAccessErrorDto: {
10059
+ error: string;
10060
+ /** @enum {string} */
10061
+ code: "leaked_token" | "removed_member" | "wrong_workspace" | "expired" | "revoked" | "invalid_grant" | "report_hidden";
10062
+ };
9364
10063
  ReportCenterExportRecordResponseDto: {
9365
10064
  /** @enum {boolean} */
9366
10065
  ok: true;
@@ -11756,6 +12455,8 @@ export interface components {
11756
12455
  };
11757
12456
  parameters: {
11758
12457
  WorkspaceId: string;
12458
+ /** @description Stored assessment report id (`tai_workspace_assessment_reports.id`). */
12459
+ AssessmentReportId: string;
11759
12460
  /** @description Eval suite id (`tai_workspace_eval_suites.id`). */
11760
12461
  EvalSuiteId: string;
11761
12462
  /** @description Platform starter pack id (kebab-case), e.g. `pr-review`. Not a UUID. */
@@ -11845,6 +12546,8 @@ export interface components {
11845
12546
  headers: never;
11846
12547
  pathItems: never;
11847
12548
  }
12549
+ export type AssessmentManifestValidationBodyDto = components['schemas']['AssessmentManifestValidationBodyDto'];
12550
+ export type AssessmentManifestValidationResultDto = components['schemas']['AssessmentManifestValidationResultDto'];
11848
12551
  export type TeamsInstallUrlDto = components['schemas']['TeamsInstallUrlDto'];
11849
12552
  export type TeamsConnectionDto = components['schemas']['TeamsConnectionDto'];
11850
12553
  export type TeamsChannelBodyDto = components['schemas']['TeamsChannelBodyDto'];
@@ -11886,6 +12589,8 @@ export type CodeIntelligenceSourcePatchDto = components['schemas']['CodeIntellig
11886
12589
  export type CodeIntelligenceSourceConfigDto = components['schemas']['CodeIntelligenceSourceConfigDto'];
11887
12590
  export type NewRelicSourceDto = components['schemas']['NewRelicSourceDto'];
11888
12591
  export type NewRelicSourceConfigDto = components['schemas']['NewRelicSourceConfigDto'];
12592
+ export type DatadogSourceDto = components['schemas']['DatadogSourceDto'];
12593
+ export type DatadogSourceConfigDto = components['schemas']['DatadogSourceConfigDto'];
11889
12594
  export type PrometheusSourceDto = components['schemas']['PrometheusSourceDto'];
11890
12595
  export type PrometheusSourceConfigDto = components['schemas']['PrometheusSourceConfigDto'];
11891
12596
  export type GrafanaSourceDto = components['schemas']['GrafanaSourceDto'];
@@ -12074,6 +12779,12 @@ export type NdaCompletionExternalDto = components['schemas']['NdaCompletionExter
12074
12779
  export type NdaExternalBodyDto = components['schemas']['NdaExternalBodyDto'];
12075
12780
  export type ReadinessDimensionDto = components['schemas']['ReadinessDimensionDto'];
12076
12781
  export type ReadinessDimensionId = components['schemas']['ReadinessDimensionId'];
12782
+ export type ExternalVcsProviderDto = components['schemas']['ExternalVcsProviderDto'];
12783
+ export type GitVcsSourceDto = components['schemas']['GitVcsSourceDto'];
12784
+ export type VcsDiscoveredRepoDto = components['schemas']['VcsDiscoveredRepoDto'];
12785
+ export type VcsRepoDiscoveryResponseDto = components['schemas']['VcsRepoDiscoveryResponseDto'];
12786
+ export type VcsProviderCoverageRowDto = components['schemas']['VcsProviderCoverageRowDto'];
12787
+ export type VcsProviderCoverageDto = components['schemas']['VcsProviderCoverageDto'];
12077
12788
  export type RepoProviderDto = components['schemas']['RepoProviderDto'];
12078
12789
  export type ReadinessAnalyzeBodyDto = components['schemas']['ReadinessAnalyzeBodyDto'];
12079
12790
  export type ReadinessInitializeResponseDto = components['schemas']['ReadinessInitializeResponseDto'];
@@ -12215,12 +12926,29 @@ export type PutAgenticFoundationRepoScopeAppliedDto = components['schemas']['Put
12215
12926
  export type PutAgenticFoundationRepoScopeFailureDto = components['schemas']['PutAgenticFoundationRepoScopeFailureDto'];
12216
12927
  export type PutAgenticFoundationRepoScopeResponseDto = components['schemas']['PutAgenticFoundationRepoScopeResponseDto'];
12217
12928
  export type ActivityLogEventTypeDto = components['schemas']['ActivityLogEventTypeDto'];
12218
- export type UnsetAssessmentDecisionDto = components['schemas']['UnsetAssessmentDecisionDto'];
12219
12929
  export type AggregateUseNoticeStatusDto = components['schemas']['AggregateUseNoticeStatusDto'];
12930
+ export type AssessmentNamedEventDto = components['schemas']['AssessmentNamedEventDto'];
12931
+ export type AssessmentRolloutDto = components['schemas']['AssessmentRolloutDto'];
12932
+ export type AssessmentRolloutPutDto = components['schemas']['AssessmentRolloutPutDto'];
12933
+ export type AssessmentRoiReasonDto = components['schemas']['AssessmentRoiReasonDto'];
12934
+ export type AssessmentRoiDayRangeDto = components['schemas']['AssessmentRoiDayRangeDto'];
12935
+ export type AssessmentRoiWindowDto = components['schemas']['AssessmentRoiWindowDto'];
12936
+ export type AssessmentRoiDto = components['schemas']['AssessmentRoiDto'];
12220
12937
  export type AggregateUseConsentDto = components['schemas']['AggregateUseConsentDto'];
12221
12938
  export type AggregateUseConsentPutDto = components['schemas']['AggregateUseConsentPutDto'];
12222
12939
  export type AssessmentDictionaryDto = components['schemas']['AssessmentDictionaryDto'];
12223
12940
  export type ReportCenterExportRecordBodyDto = components['schemas']['ReportCenterExportRecordBodyDto'];
12941
+ export type StoreAssessmentReportBodyDto = components['schemas']['StoreAssessmentReportBodyDto'];
12942
+ export type BuildAssessmentManifestBodyDto = components['schemas']['BuildAssessmentManifestBodyDto'];
12943
+ export type PrintedAssessmentRoiDto = components['schemas']['PrintedAssessmentRoiDto'];
12944
+ export type BuildAssessmentManifestResponseDto = components['schemas']['BuildAssessmentManifestResponseDto'];
12945
+ export type StoreAssessmentReportRejectedDto = components['schemas']['StoreAssessmentReportRejectedDto'];
12946
+ export type AssessmentReportLinkDto = components['schemas']['AssessmentReportLinkDto'];
12947
+ export type AssessmentReportDto = components['schemas']['AssessmentReportDto'];
12948
+ export type AssessmentReportListDto = components['schemas']['AssessmentReportListDto'];
12949
+ export type CreateAssessmentReportLinkBodyDto = components['schemas']['CreateAssessmentReportLinkBodyDto'];
12950
+ export type CreateAssessmentReportLinkResponseDto = components['schemas']['CreateAssessmentReportLinkResponseDto'];
12951
+ export type AssessmentReportAccessErrorDto = components['schemas']['AssessmentReportAccessErrorDto'];
12224
12952
  export type ReportCenterExportRecordResponseDto = components['schemas']['ReportCenterExportRecordResponseDto'];
12225
12953
  export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
12226
12954
  export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
@@ -12449,6 +13177,7 @@ export type ResponseUnauthorized = components['responses']['Unauthorized'];
12449
13177
  export type ResponseForbidden = components['responses']['Forbidden'];
12450
13178
  export type ResponseZenHrSyncInProgress = components['responses']['ZenHrSyncInProgress'];
12451
13179
  export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
13180
+ export type ParameterAssessmentReportId = components['parameters']['AssessmentReportId'];
12452
13181
  export type ParameterEvalSuiteId = components['parameters']['EvalSuiteId'];
12453
13182
  export type ParameterEvalPackId = components['parameters']['EvalPackId'];
12454
13183
  export type ParameterEvalRunId = components['parameters']['EvalRunId'];
@@ -12919,6 +13648,11 @@ export interface operations {
12919
13648
  label: string;
12920
13649
  href: string | null;
12921
13650
  } | null;
13651
+ /**
13652
+ * Format: date
13653
+ * @description America/New_York day the five-business-day clock started.
13654
+ */
13655
+ clockStartedOn: string | null;
12922
13656
  /** Format: date */
12923
13657
  dueDate: string | null;
12924
13658
  /** Format: date-time */
@@ -12962,68 +13696,7 @@ export interface operations {
12962
13696
  };
12963
13697
  requestBody: {
12964
13698
  content: {
12965
- "application/json": {
12966
- manifest: {
12967
- /** @enum {string} */
12968
- offerId: "engineering_readiness_baseline" | "agentic_ai_roi";
12969
- dictionaryVersion: string;
12970
- /** @enum {string} */
12971
- validation: "validated" | "not_validated";
12972
- /** @enum {string} */
12973
- shareMode: "internal" | "external";
12974
- /** @enum {string|null} */
12975
- watermark: "NOT VALIDATED" | "SAMPLE · SYNTHETIC DATA" | null;
12976
- scope: {
12977
- repositories: {
12978
- id: string;
12979
- name: string;
12980
- }[];
12981
- excluded: {
12982
- id: string;
12983
- name: string;
12984
- reason: string;
12985
- }[];
12986
- };
12987
- windows: {
12988
- pre: {
12989
- start: string;
12990
- end: string;
12991
- } | null;
12992
- post: {
12993
- start: string;
12994
- end: string;
12995
- } | null;
12996
- transitionDays: number;
12997
- };
12998
- sources: {
12999
- provider: string;
13000
- status: string;
13001
- freshAt: string | null;
13002
- }[];
13003
- consent: {
13004
- /** @enum {string} */
13005
- aggregateUse: "opt_in" | "opt_out" | "unset";
13006
- recordedAt: string | null;
13007
- };
13008
- sections: {
13009
- id: string;
13010
- /** @enum {string} */
13011
- status: "ok" | "failed" | "omitted";
13012
- reason?: string;
13013
- }[];
13014
- };
13015
- workspaceId: string;
13016
- expectedWorkspaceId: string;
13017
- expectedRepositoryIds: string[];
13018
- soldWindowComplete: boolean;
13019
- premiumAiAssessable: boolean;
13020
- namedPersonSectionIds: string[];
13021
- tolerances: {
13022
- id: string;
13023
- /** @enum {string} */
13024
- status: "unset" | "exceeded" | "within";
13025
- }[];
13026
- };
13699
+ "application/json": components["schemas"]["AssessmentManifestValidationBodyDto"];
13027
13700
  };
13028
13701
  };
13029
13702
  responses: {
@@ -13033,18 +13706,7 @@ export interface operations {
13033
13706
  [name: string]: unknown;
13034
13707
  };
13035
13708
  content: {
13036
- "application/json": {
13037
- buyerDeliverable: boolean;
13038
- /** @enum {string} */
13039
- validation: "validated" | "not_validated";
13040
- /** @enum {string|null} */
13041
- watermark: "NOT VALIDATED" | null;
13042
- reasons: {
13043
- code: string;
13044
- message: string;
13045
- }[];
13046
- contentHash: string;
13047
- };
13709
+ "application/json": components["schemas"]["AssessmentManifestValidationResultDto"];
13048
13710
  };
13049
13711
  };
13050
13712
  /** @description Body failed validation. */
@@ -13088,102 +13750,48 @@ export interface operations {
13088
13750
  };
13089
13751
  };
13090
13752
  };
13091
- adminListReadinessTokenUsage: {
13753
+ validateWorkspaceAssessmentManifest: {
13092
13754
  parameters: {
13093
- query?: {
13094
- /** @description Filter by workspace UUID. */
13095
- workspaceId?: string;
13096
- /** @description Filter by repository slug (e.g. `owner/repo`). */
13097
- providerSlug?: string;
13098
- /** @description Filter by operation type. */
13099
- operation?: "readiness_analysis" | "readiness_fix";
13100
- /** @description Include only rows created at or after this ISO-8601 timestamp. */
13101
- from?: string;
13102
- /** @description Include only rows created at or before this ISO-8601 timestamp. */
13103
- to?: string;
13104
- /** @description Maximum number of rows to return (default 200, max 1000). */
13105
- limit?: number;
13106
- };
13755
+ query?: never;
13107
13756
  header?: never;
13108
- path?: never;
13757
+ path: {
13758
+ workspaceId: components["parameters"]["WorkspaceId"];
13759
+ };
13109
13760
  cookie?: never;
13110
13761
  };
13111
- requestBody?: never;
13762
+ requestBody: {
13763
+ content: {
13764
+ "application/json": components["schemas"]["AssessmentManifestValidationBodyDto"];
13765
+ };
13766
+ };
13112
13767
  responses: {
13113
- /** @description Token usage rows, newest first. */
13768
+ /** @description Validation result. Client validation and watermark inputs are ignored. */
13114
13769
  200: {
13115
13770
  headers: {
13116
13771
  [name: string]: unknown;
13117
13772
  };
13118
13773
  content: {
13119
- "application/json": {
13120
- rows: components["schemas"]["ReadinessTokenUsageRowDto"][];
13121
- };
13122
- };
13123
- };
13124
- /** @description Missing or invalid JWT. */
13125
- 401: {
13126
- headers: {
13127
- [name: string]: unknown;
13128
- };
13129
- content: {
13130
- "application/json": components["schemas"]["ErrorMessageDto"];
13774
+ "application/json": components["schemas"]["AssessmentManifestValidationResultDto"];
13131
13775
  };
13132
13776
  };
13133
- /** @description Caller is not a platform admin. */
13134
- 403: {
13777
+ /** @description Body failed validation. */
13778
+ 400: {
13135
13779
  headers: {
13136
13780
  [name: string]: unknown;
13137
13781
  };
13138
13782
  content: {
13139
13783
  /**
13140
13784
  * @example {
13141
- * "error": "Forbidden",
13142
- * "code": "forbidden"
13785
+ * "error": "manifest.offerId is not a known assessment offer",
13786
+ * "code": "invalid_body"
13143
13787
  * }
13144
13788
  */
13145
13789
  "application/json": components["schemas"]["ErrorMessageDto"];
13146
13790
  };
13147
13791
  };
13148
- };
13149
- };
13150
- adminListReadinessTokenUsageByDimension: {
13151
- parameters: {
13152
- query?: {
13153
- /** @description Filter by workspace UUID. */
13154
- workspaceId?: string;
13155
- /** @description Filter by repository slug (e.g. `owner/repo`). */
13156
- providerSlug?: string;
13157
- /** @description Filter by operation type. */
13158
- operation?: "readiness_analysis" | "readiness_fix";
13159
- /** @description Filter by a specific readiness dimension ID. */
13160
- dimensionId?: string;
13161
- /** @description Include only rows whose last activity is at or after this ISO-8601 timestamp. */
13162
- from?: string;
13163
- /** @description Include only rows whose first activity is at or before this ISO-8601 timestamp. */
13164
- to?: string;
13165
- /** @description Maximum number of rows to return (default 200, max 500). */
13166
- limit?: number;
13167
- };
13168
- header?: never;
13169
- path?: never;
13170
- cookie?: never;
13171
- };
13172
- requestBody?: never;
13173
- responses: {
13174
- /** @description Token usage grouped by operation and dimension. */
13175
- 200: {
13176
- headers: {
13177
- [name: string]: unknown;
13178
- };
13179
- content: {
13180
- "application/json": {
13181
- rows: components["schemas"]["ReadinessTokenUsageByDimensionRowDto"][];
13182
- };
13183
- };
13184
- };
13185
- /** @description Missing or invalid JWT. */
13186
- 401: {
13792
+ 401: components["responses"]["Unauthorized"];
13793
+ /** @description Caller cannot validate this workspace. */
13794
+ 403: {
13187
13795
  headers: {
13188
13796
  [name: string]: unknown;
13189
13797
  };
@@ -13191,16 +13799,15 @@ export interface operations {
13191
13799
  "application/json": components["schemas"]["ErrorMessageDto"];
13192
13800
  };
13193
13801
  };
13194
- /** @description Caller is not a platform admin. */
13195
- 403: {
13802
+ /** @description Workspace does not exist. */
13803
+ 404: {
13196
13804
  headers: {
13197
13805
  [name: string]: unknown;
13198
13806
  };
13199
13807
  content: {
13200
13808
  /**
13201
13809
  * @example {
13202
- * "error": "Forbidden",
13203
- * "code": "forbidden"
13810
+ * "error": "Not found"
13204
13811
  * }
13205
13812
  */
13206
13813
  "application/json": components["schemas"]["ErrorMessageDto"];
@@ -13208,29 +13815,31 @@ export interface operations {
13208
13815
  };
13209
13816
  };
13210
13817
  };
13211
- submitPublicPrivacyRequest: {
13818
+ buildWorkspaceAssessmentManifest: {
13212
13819
  parameters: {
13213
13820
  query?: never;
13214
13821
  header?: never;
13215
- path?: never;
13822
+ path: {
13823
+ workspaceId: components["parameters"]["WorkspaceId"];
13824
+ };
13216
13825
  cookie?: never;
13217
13826
  };
13218
13827
  requestBody: {
13219
13828
  content: {
13220
- "application/json": components["schemas"]["CreatePrivacyRequestBodyDto"];
13829
+ "application/json": components["schemas"]["BuildAssessmentManifestBodyDto"];
13221
13830
  };
13222
13831
  };
13223
13832
  responses: {
13224
- /** @description Request accepted and queued for privacy ops. */
13225
- 201: {
13833
+ /** @description Server-built manifest body and its validation result. */
13834
+ 200: {
13226
13835
  headers: {
13227
13836
  [name: string]: unknown;
13228
13837
  };
13229
13838
  content: {
13230
- "application/json": components["schemas"]["CreatePrivacyRequestResultDto"];
13839
+ "application/json": components["schemas"]["BuildAssessmentManifestResponseDto"];
13231
13840
  };
13232
13841
  };
13233
- /** @description Missing or invalid email, unknown request type, or details too long. */
13842
+ /** @description Body failed validation. */
13234
13843
  400: {
13235
13844
  headers: {
13236
13845
  [name: string]: unknown;
@@ -13238,30 +13847,234 @@ export interface operations {
13238
13847
  content: {
13239
13848
  /**
13240
13849
  * @example {
13241
- * "error": "A valid email is required",
13242
- * "code": "invalid_email"
13850
+ * "error": "offerId is not a known assessment offer",
13851
+ * "code": "invalid_body"
13243
13852
  * }
13244
13853
  */
13245
13854
  "application/json": components["schemas"]["ErrorMessageDto"];
13246
13855
  };
13247
13856
  };
13248
- /** @description An open request for this email and type already exists. */
13249
- 409: {
13857
+ 401: components["responses"]["Unauthorized"];
13858
+ /** @description Caller cannot build this workspace's manifest. */
13859
+ 403: {
13250
13860
  headers: {
13251
13861
  [name: string]: unknown;
13252
13862
  };
13253
13863
  content: {
13254
13864
  /**
13255
13865
  * @example {
13256
- * "error": "An open request for this email already exists",
13257
- * "code": "duplicate_open_request"
13866
+ * "error": "Forbidden",
13867
+ * "code": "workspace_admin_required"
13258
13868
  * }
13259
13869
  */
13260
13870
  "application/json": components["schemas"]["ErrorMessageDto"];
13261
13871
  };
13262
13872
  };
13263
- /** @description Too many submissions from this client; retry later. */
13264
- 429: {
13873
+ /** @description Workspace does not exist. */
13874
+ 404: {
13875
+ headers: {
13876
+ [name: string]: unknown;
13877
+ };
13878
+ content: {
13879
+ /**
13880
+ * @example {
13881
+ * "error": "Not found"
13882
+ * }
13883
+ */
13884
+ "application/json": components["schemas"]["ErrorMessageDto"];
13885
+ };
13886
+ };
13887
+ /** @description Stored evidence could not be loaded (no database or a load failure). */
13888
+ 503: {
13889
+ headers: {
13890
+ [name: string]: unknown;
13891
+ };
13892
+ content: {
13893
+ /**
13894
+ * @example {
13895
+ * "error": "Service unavailable",
13896
+ * "code": "evidence_unavailable"
13897
+ * }
13898
+ */
13899
+ "application/json": components["schemas"]["ErrorMessageDto"];
13900
+ };
13901
+ };
13902
+ };
13903
+ };
13904
+ adminListReadinessTokenUsage: {
13905
+ parameters: {
13906
+ query?: {
13907
+ /** @description Filter by workspace UUID. */
13908
+ workspaceId?: string;
13909
+ /** @description Filter by repository slug (e.g. `owner/repo`). */
13910
+ providerSlug?: string;
13911
+ /** @description Filter by operation type. */
13912
+ operation?: "readiness_analysis" | "readiness_fix";
13913
+ /** @description Include only rows created at or after this ISO-8601 timestamp. */
13914
+ from?: string;
13915
+ /** @description Include only rows created at or before this ISO-8601 timestamp. */
13916
+ to?: string;
13917
+ /** @description Maximum number of rows to return (default 200, max 1000). */
13918
+ limit?: number;
13919
+ };
13920
+ header?: never;
13921
+ path?: never;
13922
+ cookie?: never;
13923
+ };
13924
+ requestBody?: never;
13925
+ responses: {
13926
+ /** @description Token usage rows, newest first. */
13927
+ 200: {
13928
+ headers: {
13929
+ [name: string]: unknown;
13930
+ };
13931
+ content: {
13932
+ "application/json": {
13933
+ rows: components["schemas"]["ReadinessTokenUsageRowDto"][];
13934
+ };
13935
+ };
13936
+ };
13937
+ /** @description Missing or invalid JWT. */
13938
+ 401: {
13939
+ headers: {
13940
+ [name: string]: unknown;
13941
+ };
13942
+ content: {
13943
+ "application/json": components["schemas"]["ErrorMessageDto"];
13944
+ };
13945
+ };
13946
+ /** @description Caller is not a platform admin. */
13947
+ 403: {
13948
+ headers: {
13949
+ [name: string]: unknown;
13950
+ };
13951
+ content: {
13952
+ /**
13953
+ * @example {
13954
+ * "error": "Forbidden",
13955
+ * "code": "forbidden"
13956
+ * }
13957
+ */
13958
+ "application/json": components["schemas"]["ErrorMessageDto"];
13959
+ };
13960
+ };
13961
+ };
13962
+ };
13963
+ adminListReadinessTokenUsageByDimension: {
13964
+ parameters: {
13965
+ query?: {
13966
+ /** @description Filter by workspace UUID. */
13967
+ workspaceId?: string;
13968
+ /** @description Filter by repository slug (e.g. `owner/repo`). */
13969
+ providerSlug?: string;
13970
+ /** @description Filter by operation type. */
13971
+ operation?: "readiness_analysis" | "readiness_fix";
13972
+ /** @description Filter by a specific readiness dimension ID. */
13973
+ dimensionId?: string;
13974
+ /** @description Include only rows whose last activity is at or after this ISO-8601 timestamp. */
13975
+ from?: string;
13976
+ /** @description Include only rows whose first activity is at or before this ISO-8601 timestamp. */
13977
+ to?: string;
13978
+ /** @description Maximum number of rows to return (default 200, max 500). */
13979
+ limit?: number;
13980
+ };
13981
+ header?: never;
13982
+ path?: never;
13983
+ cookie?: never;
13984
+ };
13985
+ requestBody?: never;
13986
+ responses: {
13987
+ /** @description Token usage grouped by operation and dimension. */
13988
+ 200: {
13989
+ headers: {
13990
+ [name: string]: unknown;
13991
+ };
13992
+ content: {
13993
+ "application/json": {
13994
+ rows: components["schemas"]["ReadinessTokenUsageByDimensionRowDto"][];
13995
+ };
13996
+ };
13997
+ };
13998
+ /** @description Missing or invalid JWT. */
13999
+ 401: {
14000
+ headers: {
14001
+ [name: string]: unknown;
14002
+ };
14003
+ content: {
14004
+ "application/json": components["schemas"]["ErrorMessageDto"];
14005
+ };
14006
+ };
14007
+ /** @description Caller is not a platform admin. */
14008
+ 403: {
14009
+ headers: {
14010
+ [name: string]: unknown;
14011
+ };
14012
+ content: {
14013
+ /**
14014
+ * @example {
14015
+ * "error": "Forbidden",
14016
+ * "code": "forbidden"
14017
+ * }
14018
+ */
14019
+ "application/json": components["schemas"]["ErrorMessageDto"];
14020
+ };
14021
+ };
14022
+ };
14023
+ };
14024
+ submitPublicPrivacyRequest: {
14025
+ parameters: {
14026
+ query?: never;
14027
+ header?: never;
14028
+ path?: never;
14029
+ cookie?: never;
14030
+ };
14031
+ requestBody: {
14032
+ content: {
14033
+ "application/json": components["schemas"]["CreatePrivacyRequestBodyDto"];
14034
+ };
14035
+ };
14036
+ responses: {
14037
+ /** @description Request accepted and queued for privacy ops. */
14038
+ 201: {
14039
+ headers: {
14040
+ [name: string]: unknown;
14041
+ };
14042
+ content: {
14043
+ "application/json": components["schemas"]["CreatePrivacyRequestResultDto"];
14044
+ };
14045
+ };
14046
+ /** @description Missing or invalid email, unknown request type, or details too long. */
14047
+ 400: {
14048
+ headers: {
14049
+ [name: string]: unknown;
14050
+ };
14051
+ content: {
14052
+ /**
14053
+ * @example {
14054
+ * "error": "A valid email is required",
14055
+ * "code": "invalid_email"
14056
+ * }
14057
+ */
14058
+ "application/json": components["schemas"]["ErrorMessageDto"];
14059
+ };
14060
+ };
14061
+ /** @description An open request for this email and type already exists. */
14062
+ 409: {
14063
+ headers: {
14064
+ [name: string]: unknown;
14065
+ };
14066
+ content: {
14067
+ /**
14068
+ * @example {
14069
+ * "error": "An open request for this email already exists",
14070
+ * "code": "duplicate_open_request"
14071
+ * }
14072
+ */
14073
+ "application/json": components["schemas"]["ErrorMessageDto"];
14074
+ };
14075
+ };
14076
+ /** @description Too many submissions from this client; retry later. */
14077
+ 429: {
13265
14078
  headers: {
13266
14079
  [name: string]: unknown;
13267
14080
  };
@@ -14784,7 +15597,7 @@ export interface operations {
14784
15597
  requestBody: {
14785
15598
  content: {
14786
15599
  "application/json": {
14787
- sources: (components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
15600
+ sources: (components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["DatadogSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
14788
15601
  };
14789
15602
  };
14790
15603
  };
@@ -14838,7 +15651,7 @@ export interface operations {
14838
15651
  };
14839
15652
  requestBody: {
14840
15653
  content: {
14841
- "application/json": components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"];
15654
+ "application/json": components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["DatadogSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"];
14842
15655
  };
14843
15656
  };
14844
15657
  responses: {
@@ -19264,22 +20077,544 @@ export interface operations {
19264
20077
  header?: never;
19265
20078
  path: {
19266
20079
  workspaceId: components["parameters"]["WorkspaceId"];
19267
- repoId: components["parameters"]["RepoId"];
20080
+ repoId: components["parameters"]["RepoId"];
20081
+ };
20082
+ cookie?: never;
20083
+ };
20084
+ requestBody?: never;
20085
+ responses: {
20086
+ /** @description Markdown file of readiness issues */
20087
+ 200: {
20088
+ headers: {
20089
+ [name: string]: unknown;
20090
+ };
20091
+ content: {
20092
+ "text/markdown": string;
20093
+ };
20094
+ };
20095
+ /** @description Malformed `repoId` or invalid query parameters */
20096
+ 400: {
20097
+ headers: {
20098
+ [name: string]: unknown;
20099
+ };
20100
+ content: {
20101
+ "application/json": components["schemas"]["ErrorMessageDto"];
20102
+ };
20103
+ };
20104
+ 401: components["responses"]["Unauthorized"];
20105
+ 403: components["responses"]["Forbidden"];
20106
+ /** @description Workspace or repository not found */
20107
+ 404: {
20108
+ headers: {
20109
+ [name: string]: unknown;
20110
+ };
20111
+ content: {
20112
+ "application/json": components["schemas"]["ErrorMessageDto"];
20113
+ };
20114
+ };
20115
+ };
20116
+ };
20117
+ listReadinessRepoRuns: {
20118
+ parameters: {
20119
+ query?: {
20120
+ limit?: number;
20121
+ order?: "asc" | "desc";
20122
+ /** @description Opaque cursor from a prior response `nextCursor` field. */
20123
+ cursor?: string;
20124
+ };
20125
+ header?: never;
20126
+ path: {
20127
+ workspaceId: components["parameters"]["WorkspaceId"];
20128
+ repoId: components["parameters"]["RepoId"];
20129
+ };
20130
+ cookie?: never;
20131
+ };
20132
+ requestBody?: never;
20133
+ responses: {
20134
+ /** @description Run history page */
20135
+ 200: {
20136
+ headers: {
20137
+ [name: string]: unknown;
20138
+ };
20139
+ content: {
20140
+ "application/json": components["schemas"]["ReadinessRepoRunListDto"];
20141
+ };
20142
+ };
20143
+ /** @description Invalid pagination query */
20144
+ 400: {
20145
+ headers: {
20146
+ [name: string]: unknown;
20147
+ };
20148
+ content: {
20149
+ "application/json": components["schemas"]["ErrorMessageDto"];
20150
+ };
20151
+ };
20152
+ 401: components["responses"]["Unauthorized"];
20153
+ 403: components["responses"]["Forbidden"];
20154
+ /** @description Workspace or repository not found */
20155
+ 404: {
20156
+ headers: {
20157
+ [name: string]: unknown;
20158
+ };
20159
+ content: {
20160
+ "application/json": components["schemas"]["ErrorMessageDto"];
20161
+ };
20162
+ };
20163
+ };
20164
+ };
20165
+ listReadinessAudit: {
20166
+ parameters: {
20167
+ query?: {
20168
+ limit?: number;
20169
+ offset?: number;
20170
+ order?: "asc" | "desc";
20171
+ /** @description Sort column for the activity feed. */
20172
+ sort?: "occurredAt" | "actorName" | "repoName" | "eventType" | "dimensionId";
20173
+ /** @description Case-insensitive match on actor name or email. */
20174
+ search?: string;
20175
+ eventType?: components["schemas"]["ReadinessAuditEventType"];
20176
+ dimensionId?: components["schemas"]["ReadinessDimensionId"];
20177
+ repoId?: string;
20178
+ /** @description ISO-8601 lower bound on `occurredAt` (inclusive). */
20179
+ since?: string;
20180
+ };
20181
+ header?: never;
20182
+ path: {
20183
+ workspaceId: components["parameters"]["WorkspaceId"];
20184
+ };
20185
+ cookie?: never;
20186
+ };
20187
+ requestBody?: never;
20188
+ responses: {
20189
+ /** @description Paginated audit entries */
20190
+ 200: {
20191
+ headers: {
20192
+ [name: string]: unknown;
20193
+ };
20194
+ content: {
20195
+ "application/json": components["schemas"]["ReadinessAuditListDto"];
20196
+ };
20197
+ };
20198
+ /** @description Invalid query */
20199
+ 400: {
20200
+ headers: {
20201
+ [name: string]: unknown;
20202
+ };
20203
+ content: {
20204
+ "application/json": components["schemas"]["ErrorMessageDto"];
20205
+ };
20206
+ };
20207
+ 401: components["responses"]["Unauthorized"];
20208
+ 403: components["responses"]["Forbidden"];
20209
+ /** @description Workspace does not exist */
20210
+ 404: {
20211
+ headers: {
20212
+ [name: string]: unknown;
20213
+ };
20214
+ content: {
20215
+ "application/json": components["schemas"]["ErrorMessageDto"];
20216
+ };
20217
+ };
20218
+ };
20219
+ };
20220
+ getAssessmentDictionary: {
20221
+ parameters: {
20222
+ query?: never;
20223
+ header?: never;
20224
+ path: {
20225
+ workspaceId: components["parameters"]["WorkspaceId"];
20226
+ };
20227
+ cookie?: never;
20228
+ };
20229
+ requestBody?: never;
20230
+ responses: {
20231
+ /** @description Current assessment dictionary */
20232
+ 200: {
20233
+ headers: {
20234
+ [name: string]: unknown;
20235
+ };
20236
+ content: {
20237
+ "application/json": components["schemas"]["AssessmentDictionaryDto"];
20238
+ };
20239
+ };
20240
+ 401: components["responses"]["Unauthorized"];
20241
+ 403: components["responses"]["Forbidden"];
20242
+ /** @description Workspace does not exist */
20243
+ 404: {
20244
+ headers: {
20245
+ [name: string]: unknown;
20246
+ };
20247
+ content: {
20248
+ "application/json": components["schemas"]["ErrorMessageDto"];
20249
+ };
20250
+ };
20251
+ };
20252
+ };
20253
+ getWorkspaceAssessmentRollout: {
20254
+ parameters: {
20255
+ query?: never;
20256
+ header?: never;
20257
+ path: {
20258
+ workspaceId: components["parameters"]["WorkspaceId"];
20259
+ };
20260
+ cookie?: never;
20261
+ };
20262
+ requestBody?: never;
20263
+ responses: {
20264
+ /** @description Current rollout day */
20265
+ 200: {
20266
+ headers: {
20267
+ [name: string]: unknown;
20268
+ };
20269
+ content: {
20270
+ "application/json": components["schemas"]["AssessmentRolloutDto"];
20271
+ };
20272
+ };
20273
+ 401: components["responses"]["Unauthorized"];
20274
+ 403: components["responses"]["Forbidden"];
20275
+ /** @description Workspace does not exist */
20276
+ 404: {
20277
+ headers: {
20278
+ [name: string]: unknown;
20279
+ };
20280
+ content: {
20281
+ "application/json": components["schemas"]["ErrorMessageDto"];
20282
+ };
20283
+ };
20284
+ /** @description Rollout storage is not configured */
20285
+ 503: {
20286
+ headers: {
20287
+ [name: string]: unknown;
20288
+ };
20289
+ content: {
20290
+ "application/json": components["schemas"]["ErrorMessageDto"];
20291
+ };
20292
+ };
20293
+ };
20294
+ };
20295
+ putWorkspaceAssessmentRollout: {
20296
+ parameters: {
20297
+ query?: never;
20298
+ header?: never;
20299
+ path: {
20300
+ workspaceId: components["parameters"]["WorkspaceId"];
20301
+ };
20302
+ cookie?: never;
20303
+ };
20304
+ requestBody: {
20305
+ content: {
20306
+ "application/json": components["schemas"]["AssessmentRolloutPutDto"];
20307
+ };
20308
+ };
20309
+ responses: {
20310
+ /** @description Saved rollout day */
20311
+ 200: {
20312
+ headers: {
20313
+ [name: string]: unknown;
20314
+ };
20315
+ content: {
20316
+ "application/json": components["schemas"]["AssessmentRolloutDto"];
20317
+ };
20318
+ };
20319
+ /** @description Invalid body, impossible date, or future day (`code`: `invalid_input`) */
20320
+ 400: {
20321
+ headers: {
20322
+ [name: string]: unknown;
20323
+ };
20324
+ content: {
20325
+ "application/json": components["schemas"]["ErrorMessageDto"];
20326
+ };
20327
+ };
20328
+ 401: components["responses"]["Unauthorized"];
20329
+ /** @description Caller is not a workspace admin (`code`: `workspace_admin_required`) */
20330
+ 403: {
20331
+ headers: {
20332
+ [name: string]: unknown;
20333
+ };
20334
+ content: {
20335
+ "application/json": components["schemas"]["ErrorMessageDto"];
20336
+ };
20337
+ };
20338
+ /** @description Workspace does not exist */
20339
+ 404: {
20340
+ headers: {
20341
+ [name: string]: unknown;
20342
+ };
20343
+ content: {
20344
+ "application/json": components["schemas"]["ErrorMessageDto"];
20345
+ };
20346
+ };
20347
+ /** @description Rollout storage is not configured */
20348
+ 503: {
20349
+ headers: {
20350
+ [name: string]: unknown;
20351
+ };
20352
+ content: {
20353
+ "application/json": components["schemas"]["ErrorMessageDto"];
20354
+ };
20355
+ };
20356
+ };
20357
+ };
20358
+ getWorkspaceAssessmentRoi: {
20359
+ parameters: {
20360
+ query?: never;
20361
+ header?: never;
20362
+ path: {
20363
+ workspaceId: components["parameters"]["WorkspaceId"];
20364
+ };
20365
+ cookie?: never;
20366
+ };
20367
+ requestBody?: never;
20368
+ responses: {
20369
+ /** @description Matched-period ROI result */
20370
+ 200: {
20371
+ headers: {
20372
+ [name: string]: unknown;
20373
+ };
20374
+ content: {
20375
+ "application/json": components["schemas"]["AssessmentRoiDto"];
20376
+ };
20377
+ };
20378
+ 401: components["responses"]["Unauthorized"];
20379
+ 403: components["responses"]["Forbidden"];
20380
+ /** @description Workspace does not exist */
20381
+ 404: {
20382
+ headers: {
20383
+ [name: string]: unknown;
20384
+ };
20385
+ content: {
20386
+ "application/json": components["schemas"]["ErrorMessageDto"];
20387
+ };
20388
+ };
20389
+ /** @description Evidence storage is not configured or could not be read */
20390
+ 503: {
20391
+ headers: {
20392
+ [name: string]: unknown;
20393
+ };
20394
+ content: {
20395
+ "application/json": components["schemas"]["ErrorMessageDto"];
20396
+ };
20397
+ };
20398
+ };
20399
+ };
20400
+ getAggregateUseConsent: {
20401
+ parameters: {
20402
+ query?: never;
20403
+ header?: never;
20404
+ path: {
20405
+ workspaceId: components["parameters"]["WorkspaceId"];
20406
+ };
20407
+ cookie?: never;
20408
+ };
20409
+ requestBody?: never;
20410
+ responses: {
20411
+ /** @description Current permission and the sentence reports must print */
20412
+ 200: {
20413
+ headers: {
20414
+ [name: string]: unknown;
20415
+ };
20416
+ content: {
20417
+ "application/json": components["schemas"]["AggregateUseConsentDto"];
20418
+ };
20419
+ };
20420
+ 401: components["responses"]["Unauthorized"];
20421
+ 403: components["responses"]["Forbidden"];
20422
+ /** @description Workspace does not exist */
20423
+ 404: {
20424
+ headers: {
20425
+ [name: string]: unknown;
20426
+ };
20427
+ content: {
20428
+ "application/json": components["schemas"]["ErrorMessageDto"];
20429
+ };
20430
+ };
20431
+ };
20432
+ };
20433
+ putAggregateUseConsent: {
20434
+ parameters: {
20435
+ query?: never;
20436
+ header?: never;
20437
+ path: {
20438
+ workspaceId: components["parameters"]["WorkspaceId"];
20439
+ };
20440
+ cookie?: never;
20441
+ };
20442
+ requestBody: {
20443
+ content: {
20444
+ "application/json": components["schemas"]["AggregateUseConsentPutDto"];
20445
+ };
20446
+ };
20447
+ responses: {
20448
+ /** @description Saved permission */
20449
+ 200: {
20450
+ headers: {
20451
+ [name: string]: unknown;
20452
+ };
20453
+ content: {
20454
+ "application/json": components["schemas"]["AggregateUseConsentDto"];
20455
+ };
20456
+ };
20457
+ /** @description Invalid body (`code`: `invalid_input`) */
20458
+ 400: {
20459
+ headers: {
20460
+ [name: string]: unknown;
20461
+ };
20462
+ content: {
20463
+ "application/json": components["schemas"]["ErrorMessageDto"];
20464
+ };
20465
+ };
20466
+ 401: components["responses"]["Unauthorized"];
20467
+ /** @description Caller is not a workspace admin (`code`: `workspace_admin_required`) */
20468
+ 403: {
20469
+ headers: {
20470
+ [name: string]: unknown;
20471
+ };
20472
+ content: {
20473
+ "application/json": components["schemas"]["ErrorMessageDto"];
20474
+ };
20475
+ };
20476
+ /** @description Workspace does not exist */
20477
+ 404: {
20478
+ headers: {
20479
+ [name: string]: unknown;
20480
+ };
20481
+ content: {
20482
+ "application/json": components["schemas"]["ErrorMessageDto"];
20483
+ };
20484
+ };
20485
+ /** @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`). */
20486
+ 409: {
20487
+ headers: {
20488
+ [name: string]: unknown;
20489
+ };
20490
+ content: {
20491
+ "application/json": components["schemas"]["ErrorMessageDto"];
20492
+ };
20493
+ };
20494
+ };
20495
+ };
20496
+ recordReportCenterExport: {
20497
+ parameters: {
20498
+ query?: never;
20499
+ header?: never;
20500
+ path: {
20501
+ workspaceId: components["parameters"]["WorkspaceId"];
20502
+ };
20503
+ cookie?: never;
20504
+ };
20505
+ requestBody: {
20506
+ content: {
20507
+ "application/json": components["schemas"]["ReportCenterExportRecordBodyDto"];
20508
+ };
20509
+ };
20510
+ responses: {
20511
+ /** @description Export recorded */
20512
+ 201: {
20513
+ headers: {
20514
+ [name: string]: unknown;
20515
+ };
20516
+ content: {
20517
+ "application/json": components["schemas"]["ReportCenterExportRecordResponseDto"];
20518
+ };
20519
+ };
20520
+ /** @description Invalid body */
20521
+ 400: {
20522
+ headers: {
20523
+ [name: string]: unknown;
20524
+ };
20525
+ content: {
20526
+ "application/json": components["schemas"]["ErrorMessageDto"];
20527
+ };
20528
+ };
20529
+ 401: components["responses"]["Unauthorized"];
20530
+ 403: components["responses"]["Forbidden"];
20531
+ /** @description Workspace does not exist */
20532
+ 404: {
20533
+ headers: {
20534
+ [name: string]: unknown;
20535
+ };
20536
+ content: {
20537
+ "application/json": components["schemas"]["ErrorMessageDto"];
20538
+ };
20539
+ };
20540
+ /** @description Activity log is not supported by this backend build */
20541
+ 501: {
20542
+ headers: {
20543
+ [name: string]: unknown;
20544
+ };
20545
+ content: {
20546
+ "application/json": components["schemas"]["ErrorMessageDto"];
20547
+ };
20548
+ };
20549
+ };
20550
+ };
20551
+ listAssessmentReports: {
20552
+ parameters: {
20553
+ query?: never;
20554
+ header?: never;
20555
+ path: {
20556
+ workspaceId: components["parameters"]["WorkspaceId"];
20557
+ };
20558
+ cookie?: never;
20559
+ };
20560
+ requestBody?: never;
20561
+ responses: {
20562
+ /** @description Stored reports, newest first */
20563
+ 200: {
20564
+ headers: {
20565
+ [name: string]: unknown;
20566
+ };
20567
+ content: {
20568
+ "application/json": components["schemas"]["AssessmentReportListDto"];
20569
+ };
20570
+ };
20571
+ 401: components["responses"]["Unauthorized"];
20572
+ 403: components["responses"]["Forbidden"];
20573
+ /** @description Workspace does not exist */
20574
+ 404: {
20575
+ headers: {
20576
+ [name: string]: unknown;
20577
+ };
20578
+ content: {
20579
+ "application/json": components["schemas"]["ErrorMessageDto"];
20580
+ };
20581
+ };
20582
+ /** @description Stored reports are not supported by this backend build (no database) */
20583
+ 501: {
20584
+ headers: {
20585
+ [name: string]: unknown;
20586
+ };
20587
+ content: {
20588
+ "application/json": components["schemas"]["ErrorMessageDto"];
20589
+ };
20590
+ };
20591
+ };
20592
+ };
20593
+ storeAssessmentReport: {
20594
+ parameters: {
20595
+ query?: never;
20596
+ header?: never;
20597
+ path: {
20598
+ workspaceId: components["parameters"]["WorkspaceId"];
19268
20599
  };
19269
20600
  cookie?: never;
19270
20601
  };
19271
- requestBody?: never;
20602
+ requestBody: {
20603
+ content: {
20604
+ "application/json": components["schemas"]["StoreAssessmentReportBodyDto"];
20605
+ };
20606
+ };
19272
20607
  responses: {
19273
- /** @description Markdown file of readiness issues */
19274
- 200: {
20608
+ /** @description Report stored */
20609
+ 201: {
19275
20610
  headers: {
19276
20611
  [name: string]: unknown;
19277
20612
  };
19278
20613
  content: {
19279
- "text/markdown": string;
20614
+ "application/json": components["schemas"]["AssessmentReportDto"];
19280
20615
  };
19281
20616
  };
19282
- /** @description Malformed `repoId` or invalid query parameters */
20617
+ /** @description Body is not valid, or the file is not a PDF or is too large */
19283
20618
  400: {
19284
20619
  headers: {
19285
20620
  [name: string]: unknown;
@@ -19290,7 +20625,7 @@ export interface operations {
19290
20625
  };
19291
20626
  401: components["responses"]["Unauthorized"];
19292
20627
  403: components["responses"]["Forbidden"];
19293
- /** @description Workspace or repository not found */
20628
+ /** @description Workspace does not exist */
19294
20629
  404: {
19295
20630
  headers: {
19296
20631
  [name: string]: unknown;
@@ -19299,36 +20634,17 @@ export interface operations {
19299
20634
  "application/json": components["schemas"]["ErrorMessageDto"];
19300
20635
  };
19301
20636
  };
19302
- };
19303
- };
19304
- listReadinessRepoRuns: {
19305
- parameters: {
19306
- query?: {
19307
- limit?: number;
19308
- order?: "asc" | "desc";
19309
- /** @description Opaque cursor from a prior response `nextCursor` field. */
19310
- cursor?: string;
19311
- };
19312
- header?: never;
19313
- path: {
19314
- workspaceId: components["parameters"]["WorkspaceId"];
19315
- repoId: components["parameters"]["RepoId"];
19316
- };
19317
- cookie?: never;
19318
- };
19319
- requestBody?: never;
19320
- responses: {
19321
- /** @description Run history page */
19322
- 200: {
20637
+ /** @description `not_buyer_deliverable` (the rebuilt manifest did not validate as an internal buyer file; includes `reasons`) or `manifest_changed` (stored evidence changed since the PDF was built, so `contentHash` differs; export again). */
20638
+ 422: {
19323
20639
  headers: {
19324
20640
  [name: string]: unknown;
19325
20641
  };
19326
20642
  content: {
19327
- "application/json": components["schemas"]["ReadinessRepoRunListDto"];
20643
+ "application/json": components["schemas"]["StoreAssessmentReportRejectedDto"];
19328
20644
  };
19329
20645
  };
19330
- /** @description Invalid pagination query */
19331
- 400: {
20646
+ /** @description Stored reports are not supported by this backend build (no database) */
20647
+ 501: {
19332
20648
  headers: {
19333
20649
  [name: string]: unknown;
19334
20650
  };
@@ -19336,10 +20652,8 @@ export interface operations {
19336
20652
  "application/json": components["schemas"]["ErrorMessageDto"];
19337
20653
  };
19338
20654
  };
19339
- 401: components["responses"]["Unauthorized"];
19340
- 403: components["responses"]["Forbidden"];
19341
- /** @description Workspace or repository not found */
19342
- 404: {
20655
+ /** @description Stored evidence could not be loaded to rebuild the manifest. */
20656
+ 503: {
19343
20657
  headers: {
19344
20658
  [name: string]: unknown;
19345
20659
  };
@@ -19349,40 +20663,33 @@ export interface operations {
19349
20663
  };
19350
20664
  };
19351
20665
  };
19352
- listReadinessAudit: {
20666
+ createAssessmentReportLink: {
19353
20667
  parameters: {
19354
- query?: {
19355
- limit?: number;
19356
- offset?: number;
19357
- order?: "asc" | "desc";
19358
- /** @description Sort column for the activity feed. */
19359
- sort?: "occurredAt" | "actorName" | "repoName" | "eventType" | "dimensionId";
19360
- /** @description Case-insensitive match on actor name or email. */
19361
- search?: string;
19362
- eventType?: components["schemas"]["ReadinessAuditEventType"];
19363
- dimensionId?: components["schemas"]["ReadinessDimensionId"];
19364
- repoId?: string;
19365
- /** @description ISO-8601 lower bound on `occurredAt` (inclusive). */
19366
- since?: string;
19367
- };
20668
+ query?: never;
19368
20669
  header?: never;
19369
20670
  path: {
19370
20671
  workspaceId: components["parameters"]["WorkspaceId"];
20672
+ /** @description Stored assessment report id (`tai_workspace_assessment_reports.id`). */
20673
+ reportId: components["parameters"]["AssessmentReportId"];
19371
20674
  };
19372
20675
  cookie?: never;
19373
20676
  };
19374
- requestBody?: never;
20677
+ requestBody: {
20678
+ content: {
20679
+ "application/json": components["schemas"]["CreateAssessmentReportLinkBodyDto"];
20680
+ };
20681
+ };
19375
20682
  responses: {
19376
- /** @description Paginated audit entries */
19377
- 200: {
20683
+ /** @description Link created */
20684
+ 201: {
19378
20685
  headers: {
19379
20686
  [name: string]: unknown;
19380
20687
  };
19381
20688
  content: {
19382
- "application/json": components["schemas"]["ReadinessAuditListDto"];
20689
+ "application/json": components["schemas"]["CreateAssessmentReportLinkResponseDto"];
19383
20690
  };
19384
20691
  };
19385
- /** @description Invalid query */
20692
+ /** @description Body is not valid */
19386
20693
  400: {
19387
20694
  headers: {
19388
20695
  [name: string]: unknown;
@@ -19393,7 +20700,7 @@ export interface operations {
19393
20700
  };
19394
20701
  401: components["responses"]["Unauthorized"];
19395
20702
  403: components["responses"]["Forbidden"];
19396
- /** @description Workspace does not exist */
20703
+ /** @description Workspace or report not found (`report_not_found`) */
19397
20704
  404: {
19398
20705
  headers: {
19399
20706
  [name: string]: unknown;
@@ -19402,31 +20709,61 @@ export interface operations {
19402
20709
  "application/json": components["schemas"]["ErrorMessageDto"];
19403
20710
  };
19404
20711
  };
20712
+ /** @description The report is hidden (`report_hidden`) */
20713
+ 409: {
20714
+ headers: {
20715
+ [name: string]: unknown;
20716
+ };
20717
+ content: {
20718
+ "application/json": components["schemas"]["ErrorMessageDto"];
20719
+ };
20720
+ };
20721
+ /** @description The recipient is not a current workspace member (`recipient_not_member`) */
20722
+ 422: {
20723
+ headers: {
20724
+ [name: string]: unknown;
20725
+ };
20726
+ content: {
20727
+ "application/json": components["schemas"]["ErrorMessageDto"];
20728
+ };
20729
+ };
20730
+ /** @description Stored reports or member listing are not supported by this backend build */
20731
+ 501: {
20732
+ headers: {
20733
+ [name: string]: unknown;
20734
+ };
20735
+ content: {
20736
+ "application/json": components["schemas"]["ErrorMessageDto"];
20737
+ };
20738
+ };
19405
20739
  };
19406
20740
  };
19407
- getAssessmentDictionary: {
20741
+ revokeAssessmentReportLink: {
19408
20742
  parameters: {
19409
20743
  query?: never;
19410
20744
  header?: never;
19411
20745
  path: {
19412
20746
  workspaceId: components["parameters"]["WorkspaceId"];
20747
+ /** @description Stored assessment report id (`tai_workspace_assessment_reports.id`). */
20748
+ reportId: components["parameters"]["AssessmentReportId"];
20749
+ grantId: string;
19413
20750
  };
19414
20751
  cookie?: never;
19415
20752
  };
19416
20753
  requestBody?: never;
19417
20754
  responses: {
19418
- /** @description Current assessment dictionary */
20755
+ /** @description Revoked link */
19419
20756
  200: {
19420
20757
  headers: {
19421
20758
  [name: string]: unknown;
19422
20759
  };
19423
20760
  content: {
19424
- "application/json": components["schemas"]["AssessmentDictionaryDto"];
20761
+ "application/json": components["schemas"]["AssessmentReportLinkDto"];
19425
20762
  };
19426
20763
  };
19427
20764
  401: components["responses"]["Unauthorized"];
19428
20765
  403: components["responses"]["Forbidden"];
19429
- /** @description Workspace does not exist */
20766
+ /** @description Workspace, report, or link not found */
19430
20767
  404: {
19431
20768
  headers: {
19432
20769
  [name: string]: unknown;
@@ -19435,31 +20772,42 @@ export interface operations {
19435
20772
  "application/json": components["schemas"]["ErrorMessageDto"];
19436
20773
  };
19437
20774
  };
20775
+ /** @description Stored reports are not supported by this backend build (no database) */
20776
+ 501: {
20777
+ headers: {
20778
+ [name: string]: unknown;
20779
+ };
20780
+ content: {
20781
+ "application/json": components["schemas"]["ErrorMessageDto"];
20782
+ };
20783
+ };
19438
20784
  };
19439
20785
  };
19440
- getAggregateUseConsent: {
20786
+ hideAssessmentReport: {
19441
20787
  parameters: {
19442
20788
  query?: never;
19443
20789
  header?: never;
19444
20790
  path: {
19445
20791
  workspaceId: components["parameters"]["WorkspaceId"];
20792
+ /** @description Stored assessment report id (`tai_workspace_assessment_reports.id`). */
20793
+ reportId: components["parameters"]["AssessmentReportId"];
19446
20794
  };
19447
20795
  cookie?: never;
19448
20796
  };
19449
20797
  requestBody?: never;
19450
20798
  responses: {
19451
- /** @description Current permission and the sentence reports must print */
20799
+ /** @description Hidden report (`links` is empty in this response; list again for links) */
19452
20800
  200: {
19453
20801
  headers: {
19454
20802
  [name: string]: unknown;
19455
20803
  };
19456
20804
  content: {
19457
- "application/json": components["schemas"]["AggregateUseConsentDto"];
20805
+ "application/json": components["schemas"]["AssessmentReportDto"];
19458
20806
  };
19459
20807
  };
19460
20808
  401: components["responses"]["Unauthorized"];
19461
20809
  403: components["responses"]["Forbidden"];
19462
- /** @description Workspace does not exist */
20810
+ /** @description Workspace or report not found */
19463
20811
  404: {
19464
20812
  headers: {
19465
20813
  [name: string]: unknown;
@@ -19468,44 +20816,43 @@ export interface operations {
19468
20816
  "application/json": components["schemas"]["ErrorMessageDto"];
19469
20817
  };
19470
20818
  };
20819
+ /** @description Stored reports are not supported by this backend build (no database) */
20820
+ 501: {
20821
+ headers: {
20822
+ [name: string]: unknown;
20823
+ };
20824
+ content: {
20825
+ "application/json": components["schemas"]["ErrorMessageDto"];
20826
+ };
20827
+ };
19471
20828
  };
19472
20829
  };
19473
- putAggregateUseConsent: {
20830
+ restoreAssessmentReport: {
19474
20831
  parameters: {
19475
20832
  query?: never;
19476
20833
  header?: never;
19477
20834
  path: {
19478
20835
  workspaceId: components["parameters"]["WorkspaceId"];
20836
+ /** @description Stored assessment report id (`tai_workspace_assessment_reports.id`). */
20837
+ reportId: components["parameters"]["AssessmentReportId"];
19479
20838
  };
19480
20839
  cookie?: never;
19481
20840
  };
19482
- requestBody: {
19483
- content: {
19484
- "application/json": components["schemas"]["AggregateUseConsentPutDto"];
19485
- };
19486
- };
20841
+ requestBody?: never;
19487
20842
  responses: {
19488
- /** @description Saved permission */
20843
+ /** @description Restored report (`links` is empty in this response; list again for links) */
19489
20844
  200: {
19490
20845
  headers: {
19491
20846
  [name: string]: unknown;
19492
20847
  };
19493
20848
  content: {
19494
- "application/json": components["schemas"]["AggregateUseConsentDto"];
19495
- };
19496
- };
19497
- /** @description Invalid body (`code`: `invalid_input`) */
19498
- 400: {
19499
- headers: {
19500
- [name: string]: unknown;
19501
- };
19502
- content: {
19503
- "application/json": components["schemas"]["ErrorMessageDto"];
20849
+ "application/json": components["schemas"]["AssessmentReportDto"];
19504
20850
  };
19505
20851
  };
19506
20852
  401: components["responses"]["Unauthorized"];
19507
- /** @description Caller is not a workspace admin (`code`: `workspace_admin_required`) */
19508
- 403: {
20853
+ 403: components["responses"]["Forbidden"];
20854
+ /** @description Workspace or report not found */
20855
+ 404: {
19509
20856
  headers: {
19510
20857
  [name: string]: unknown;
19511
20858
  };
@@ -19513,8 +20860,8 @@ export interface operations {
19513
20860
  "application/json": components["schemas"]["ErrorMessageDto"];
19514
20861
  };
19515
20862
  };
19516
- /** @description Workspace does not exist */
19517
- 404: {
20863
+ /** @description `not_hidden` or `restore_window_ended` */
20864
+ 409: {
19518
20865
  headers: {
19519
20866
  [name: string]: unknown;
19520
20867
  };
@@ -19522,8 +20869,8 @@ export interface operations {
19522
20869
  "application/json": components["schemas"]["ErrorMessageDto"];
19523
20870
  };
19524
20871
  };
19525
- /** @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`). */
19526
- 409: {
20872
+ /** @description Stored reports are not supported by this backend build (no database) */
20873
+ 501: {
19527
20874
  headers: {
19528
20875
  [name: string]: unknown;
19529
20876
  };
@@ -19533,43 +20880,58 @@ export interface operations {
19533
20880
  };
19534
20881
  };
19535
20882
  };
19536
- recordReportCenterExport: {
20883
+ downloadAssessmentReport: {
19537
20884
  parameters: {
19538
- query?: never;
19539
- header?: never;
19540
- path: {
19541
- workspaceId: components["parameters"]["WorkspaceId"];
20885
+ query: {
20886
+ /** @description Opaque link token from the email (`secureLinkQuery`). */
20887
+ t: string;
19542
20888
  };
20889
+ header?: never;
20890
+ path?: never;
19543
20891
  cookie?: never;
19544
20892
  };
19545
- requestBody: {
19546
- content: {
19547
- "application/json": components["schemas"]["ReportCenterExportRecordBodyDto"];
19548
- };
19549
- };
20893
+ requestBody?: never;
19550
20894
  responses: {
19551
- /** @description Export recorded */
19552
- 201: {
20895
+ /** @description The decrypted PDF */
20896
+ 200: {
19553
20897
  headers: {
20898
+ "Cache-Control"?: "no-store";
19554
20899
  [name: string]: unknown;
19555
20900
  };
19556
20901
  content: {
19557
- "application/json": components["schemas"]["ReportCenterExportRecordResponseDto"];
20902
+ "application/pdf": string;
19558
20903
  };
19559
20904
  };
19560
- /** @description Invalid body */
19561
- 400: {
20905
+ 401: components["responses"]["Unauthorized"];
20906
+ /** @description `leaked_token`, `removed_member`, or `wrong_workspace` */
20907
+ 403: {
19562
20908
  headers: {
19563
20909
  [name: string]: unknown;
19564
20910
  };
19565
20911
  content: {
19566
- "application/json": components["schemas"]["ErrorMessageDto"];
20912
+ "application/json": components["schemas"]["AssessmentReportAccessErrorDto"];
19567
20913
  };
19568
20914
  };
19569
- 401: components["responses"]["Unauthorized"];
19570
- 403: components["responses"]["Forbidden"];
19571
- /** @description Workspace does not exist */
20915
+ /** @description `invalid_grant` */
19572
20916
  404: {
20917
+ headers: {
20918
+ [name: string]: unknown;
20919
+ };
20920
+ content: {
20921
+ "application/json": components["schemas"]["AssessmentReportAccessErrorDto"];
20922
+ };
20923
+ };
20924
+ /** @description `expired`, `revoked`, or `report_hidden` */
20925
+ 410: {
20926
+ headers: {
20927
+ [name: string]: unknown;
20928
+ };
20929
+ content: {
20930
+ "application/json": components["schemas"]["AssessmentReportAccessErrorDto"];
20931
+ };
20932
+ };
20933
+ /** @description The stored report could not be decrypted (`report_unreadable`) */
20934
+ 500: {
19573
20935
  headers: {
19574
20936
  [name: string]: unknown;
19575
20937
  };
@@ -19577,7 +20939,7 @@ export interface operations {
19577
20939
  "application/json": components["schemas"]["ErrorMessageDto"];
19578
20940
  };
19579
20941
  };
19580
- /** @description Activity log is not supported by this backend build */
20942
+ /** @description Stored reports are not supported by this backend build (no database) */
19581
20943
  501: {
19582
20944
  headers: {
19583
20945
  [name: string]: unknown;
@@ -24955,6 +26317,83 @@ export interface operations {
24955
26317
  403: components["responses"]["Forbidden"];
24956
26318
  };
24957
26319
  };
26320
+ postWorkspaceVcsRepoDiscovery: {
26321
+ parameters: {
26322
+ query?: never;
26323
+ header?: never;
26324
+ path: {
26325
+ workspaceId: components["parameters"]["WorkspaceId"];
26326
+ };
26327
+ cookie?: never;
26328
+ };
26329
+ requestBody: {
26330
+ content: {
26331
+ "application/json": components["schemas"]["GitVcsSourceDto"];
26332
+ };
26333
+ };
26334
+ responses: {
26335
+ /** @description Repositories the source can read */
26336
+ 200: {
26337
+ headers: {
26338
+ [name: string]: unknown;
26339
+ };
26340
+ content: {
26341
+ "application/json": components["schemas"]["VcsRepoDiscoveryResponseDto"];
26342
+ };
26343
+ };
26344
+ /** @description Invalid source (`error` is a code such as `base_url_required`, `base_url_invalid`, `base_url_not_https`, `base_url_has_credentials`, `base_url_has_path`, `base_url_host_blocked`, `env_ref_not_allowed`, `account_missing`, `token_missing`, `unsupported_type`). */
26345
+ 400: {
26346
+ headers: {
26347
+ [name: string]: unknown;
26348
+ };
26349
+ content: {
26350
+ "application/json": components["schemas"]["ErrorMessageDto"];
26351
+ };
26352
+ };
26353
+ 401: components["responses"]["Unauthorized"];
26354
+ 403: components["responses"]["Forbidden"];
26355
+ /** @description The provider rejected or failed the listing (`error` is `unauthorized`, `forbidden`, `not_found`, `rate_limited`, or `discovery_failed`). */
26356
+ 502: {
26357
+ headers: {
26358
+ [name: string]: unknown;
26359
+ };
26360
+ content: {
26361
+ "application/json": components["schemas"]["ErrorMessageDto"];
26362
+ };
26363
+ };
26364
+ };
26365
+ };
26366
+ getWorkspaceVcsProviderCoverage: {
26367
+ parameters: {
26368
+ query?: never;
26369
+ header?: never;
26370
+ path: {
26371
+ workspaceId: components["parameters"]["WorkspaceId"];
26372
+ };
26373
+ cookie?: never;
26374
+ };
26375
+ requestBody?: never;
26376
+ responses: {
26377
+ /** @description Server-computed provider coverage */
26378
+ 200: {
26379
+ headers: {
26380
+ [name: string]: unknown;
26381
+ };
26382
+ content: {
26383
+ "application/json": components["schemas"]["VcsProviderCoverageDto"];
26384
+ };
26385
+ };
26386
+ 401: components["responses"]["Unauthorized"];
26387
+ 403: components["responses"]["Forbidden"];
26388
+ /** @description Store does not support provider coverage */
26389
+ 501: {
26390
+ headers: {
26391
+ [name: string]: unknown;
26392
+ };
26393
+ content?: never;
26394
+ };
26395
+ };
26396
+ };
24958
26397
  retryWorkspaceProductivityRepo: {
24959
26398
  parameters: {
24960
26399
  query?: never;