@thinkai/tai-api-contract 2.8.2 → 2.8.4

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.
@@ -309,7 +309,7 @@ export interface paths {
309
309
  };
310
310
  /**
311
311
  * Productivity insights — top teams and team drilldown
312
- * @description Without `teamId`: returns the top-ranked teams by average weekly merged PR count for the Measure **Top teams** widget on /phase-c/c4 and /phase-c/c7. With `teamId`: returns weekly rollup and summary for a single team (powers `/phase-c/c4/teams/:teamId` drilldown).
312
+ * @description Without `teamId`: returns the top-ranked teams by average weekly merged PR count for the Measure **Top teams** widget on /phase-c/c4 and /phase-c/c7. With `teamId`: returns weekly rollup and summary for a single team (powers `/phase-c/c4/teams/:teamId` drilldown). When `year` is also set, returns daily buckets aggregated across team members for the GitHub-style yearly heatmap.
313
313
  */
314
314
  get: operations["getProductivityInsightsTeams"];
315
315
  put?: never;
@@ -1839,6 +1839,13 @@ export interface components {
1839
1839
  teamName: string;
1840
1840
  headcount: number;
1841
1841
  managerLabel?: string;
1842
+ /** @description True when the team aggregates GitHub logins not mapped in the org chart (`teamId` `__other`). */
1843
+ notInOrgChart?: boolean;
1844
+ /** @description Present when the request included `year` — calendar-year heatmap mode. */
1845
+ year?: number;
1846
+ /** @description Daily buckets aggregated across team members when `year` is set. */
1847
+ heatmapWeeks?: components["schemas"]["ProductivityInsightsContributorActivityWeekDto"][];
1848
+ heatmapSummary?: components["schemas"]["ProductivityInsightsContributorActivitySummaryDto"];
1842
1849
  weeks: components["schemas"]["ProductivityInsightsAggregatedTeamWeekDto"][];
1843
1850
  summary: components["schemas"]["ProductivityInsightsTeamSummaryDto"];
1844
1851
  };
@@ -1847,6 +1854,8 @@ export interface components {
1847
1854
  workspaceId: string;
1848
1855
  /** @enum {string} */
1849
1856
  range: "4w" | "8w" | "q";
1857
+ /** @description Present when the request included `year` — calendar-year heatmap mode. */
1858
+ year?: number;
1850
1859
  scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
1851
1860
  /** Format: date-time */
1852
1861
  generatedAt: string;
@@ -1877,6 +1886,13 @@ export interface components {
1877
1886
  absenceType?: string;
1878
1887
  failureSignal: boolean;
1879
1888
  failures: string[];
1889
+ /** @description Optional PR rows with GitHub links when ingest stored URLs. */
1890
+ mergedPrItems?: components["schemas"]["ProductivityInsightsContributorMergedPrItemDto"][];
1891
+ };
1892
+ ProductivityInsightsContributorMergedPrItemDto: {
1893
+ label: string;
1894
+ /** Format: uri */
1895
+ url?: string;
1880
1896
  };
1881
1897
  ProductivityInsightsContributorActivityWeekDto: {
1882
1898
  label: string;
@@ -1902,6 +1918,8 @@ export interface components {
1902
1918
  contributorId: string;
1903
1919
  /** @enum {string} */
1904
1920
  range: "4w" | "8w" | "q";
1921
+ /** @description Present when the request included `year` — calendar-year heatmap mode. */
1922
+ year?: number;
1905
1923
  scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
1906
1924
  /** Format: date-time */
1907
1925
  generatedAt: string;
@@ -2216,11 +2234,27 @@ export interface components {
2216
2234
  /** @description Human-readable summary for UI when permissionsUpgradeRequired is true. */
2217
2235
  upgradeMessage?: string | null;
2218
2236
  };
2237
+ GithubPendingApprovalDto: {
2238
+ /**
2239
+ * Format: uuid
2240
+ * @description Pending workspace integration row id (for cancel).
2241
+ */
2242
+ integrationId: string;
2243
+ /** @description GitHub org login from the install request, when known. */
2244
+ requestedAccountLogin?: string | null;
2245
+ /**
2246
+ * Format: date-time
2247
+ * @description When the pending install request was recorded.
2248
+ */
2249
+ pendingSince: string;
2250
+ };
2219
2251
  GithubInstallationStatusDto: {
2220
2252
  installed: boolean;
2221
2253
  installations: components["schemas"]["GithubInstallationSummaryDto"][];
2222
2254
  /** @description True if any connected installation is under-permissioned. */
2223
2255
  permissionsUpgradeRequired: boolean;
2256
+ /** @description Present when an org admin must approve the GitHub App install request. */
2257
+ pendingApproval?: components["schemas"]["GithubPendingApprovalDto"] | null;
2224
2258
  installationId?: string | null;
2225
2259
  account?: components["schemas"]["GithubAccountDto"] | null;
2226
2260
  /** @description Paginated merged installation repositories when `installed` is true. */
@@ -2957,6 +2991,7 @@ export type ProductivityInsightsTeamDetailDto = components['schemas']['Productiv
2957
2991
  export type ProductivityInsightsTeamsResponseDto = components['schemas']['ProductivityInsightsTeamsResponseDto'];
2958
2992
  export type ProductivityInsightsContributorProfileDto = components['schemas']['ProductivityInsightsContributorProfileDto'];
2959
2993
  export type ProductivityInsightsContributorActivityDayDto = components['schemas']['ProductivityInsightsContributorActivityDayDto'];
2994
+ export type ProductivityInsightsContributorMergedPrItemDto = components['schemas']['ProductivityInsightsContributorMergedPrItemDto'];
2960
2995
  export type ProductivityInsightsContributorActivityWeekDto = components['schemas']['ProductivityInsightsContributorActivityWeekDto'];
2961
2996
  export type ProductivityInsightsContributorActivitySummaryDto = components['schemas']['ProductivityInsightsContributorActivitySummaryDto'];
2962
2997
  export type ProductivityInsightsContributorDetailDto = components['schemas']['ProductivityInsightsContributorDetailDto'];
@@ -2990,6 +3025,7 @@ export type GithubAccountDto = components['schemas']['GithubAccountDto'];
2990
3025
  export type GithubInstalledRepoDto = components['schemas']['GithubInstalledRepoDto'];
2991
3026
  export type GithubMissingPermissionDto = components['schemas']['GithubMissingPermissionDto'];
2992
3027
  export type GithubInstallationSummaryDto = components['schemas']['GithubInstallationSummaryDto'];
3028
+ export type GithubPendingApprovalDto = components['schemas']['GithubPendingApprovalDto'];
2993
3029
  export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
2994
3030
  export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
2995
3031
  export type GithubInstallUrlResponseDto = components['schemas']['GithubInstallUrlResponseDto'];
@@ -3879,6 +3915,8 @@ export interface operations {
3879
3915
  team?: string;
3880
3916
  /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
3881
3917
  windowEnd?: string;
3918
+ /** @description Calendar year (e.g. 2026) for GitHub-style yearly contribution heatmap on `/phase-c/c4/teams/:teamId`. Aggregates merged PRs across all team members for that year instead of the `rangeId` window. Requires `teamId`. */
3919
+ year?: number;
3882
3920
  };
3883
3921
  header?: never;
3884
3922
  path: {
@@ -3931,6 +3969,8 @@ export interface operations {
3931
3969
  team?: string;
3932
3970
  /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
3933
3971
  windowEnd?: string;
3972
+ /** @description Calendar year (e.g. 2026) for GitHub-style yearly contribution heatmap on `/phase-c/c4/contributors/:id`. When set, returns weekly buckets overlapping that year instead of the `rangeId` window. */
3973
+ year?: number;
3934
3974
  };
3935
3975
  header?: never;
3936
3976
  path: {