@thinkai/tai-api-contract 2.2.0 → 2.2.2

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.
@@ -210,109 +210,6 @@ export interface paths {
210
210
  patch?: never;
211
211
  trace?: never;
212
212
  };
213
- "/admin/reviews": {
214
- parameters: {
215
- query?: never;
216
- header?: never;
217
- path?: never;
218
- cookie?: never;
219
- };
220
- /** Admin review queue */
221
- get: operations["listAdminReviews"];
222
- put?: never;
223
- post?: never;
224
- delete?: never;
225
- options?: never;
226
- head?: never;
227
- patch?: never;
228
- trace?: never;
229
- };
230
- "/admin/reviews/{id}": {
231
- parameters: {
232
- query?: never;
233
- header?: never;
234
- path?: never;
235
- cookie?: never;
236
- };
237
- /** Single review submission */
238
- get: operations["getAdminReview"];
239
- put?: never;
240
- post?: never;
241
- delete?: never;
242
- options?: never;
243
- head?: never;
244
- /** Update review metadata */
245
- patch: operations["patchAdminReview"];
246
- trace?: never;
247
- };
248
- "/admin/reviews/{id}/sections/{sectionId}/comments": {
249
- parameters: {
250
- query?: never;
251
- header?: never;
252
- path?: never;
253
- cookie?: never;
254
- };
255
- get?: never;
256
- put?: never;
257
- /** Add section comment */
258
- post: operations["postAdminReviewComment"];
259
- delete?: never;
260
- options?: never;
261
- head?: never;
262
- patch?: never;
263
- trace?: never;
264
- };
265
- "/admin/reviews/{id}/sections/{sectionId}/decision": {
266
- parameters: {
267
- query?: never;
268
- header?: never;
269
- path?: never;
270
- cookie?: never;
271
- };
272
- get?: never;
273
- /** Set section decision */
274
- put: operations["putAdminReviewSectionDecision"];
275
- post?: never;
276
- delete?: never;
277
- options?: never;
278
- head?: never;
279
- patch?: never;
280
- trace?: never;
281
- };
282
- "/admin/reviews/{id}/pricing": {
283
- parameters: {
284
- query?: never;
285
- header?: never;
286
- path?: never;
287
- cookie?: never;
288
- };
289
- get?: never;
290
- /** Update pricing lines */
291
- put: operations["putAdminReviewPricing"];
292
- post?: never;
293
- delete?: never;
294
- options?: never;
295
- head?: never;
296
- patch?: never;
297
- trace?: never;
298
- };
299
- "/admin/reviews/{id}/deployment": {
300
- parameters: {
301
- query?: never;
302
- header?: never;
303
- path?: never;
304
- cookie?: never;
305
- };
306
- get?: never;
307
- /** Update deployment plan */
308
- put: operations["putAdminReviewDeployment"];
309
- post?: never;
310
- delete?: never;
311
- options?: never;
312
- head?: never;
313
- patch?: never;
314
- trace?: never;
315
- };
316
213
  "/workspaces/{workspaceId}/company-profile": {
317
214
  parameters: {
318
215
  query?: never;
@@ -381,7 +278,10 @@ export interface paths {
381
278
  path?: never;
382
279
  cookie?: never;
383
280
  };
384
- /** GitHub App installation callback */
281
+ /**
282
+ * GitHub App installation callback
283
+ * @description Public callback endpoint used by GitHub App installation flow. Resolves and consumes install state, persists workspace installation linkage, then redirects to configured SPA origin with status markers.
284
+ */
385
285
  get: operations["getGithubInstallCallback"];
386
286
  put?: never;
387
287
  post?: never;
@@ -400,7 +300,10 @@ export interface paths {
400
300
  };
401
301
  get?: never;
402
302
  put?: never;
403
- /** GitHub App webhook receiver */
303
+ /**
304
+ * GitHub App webhook receiver
305
+ * @description Public webhook endpoint that verifies `X-Hub-Signature-256` and updates or removes workspace GitHub integration/cache state for installation events.
306
+ */
404
307
  post: operations["postGithubWebhook"];
405
308
  delete?: never;
406
309
  options?: never;
@@ -840,7 +743,13 @@ export interface components {
840
743
  [key: string]: unknown;
841
744
  };
842
745
  DashboardProductivityDto: {
746
+ /** Format: uuid */
843
747
  workspaceId: string;
748
+ /**
749
+ * Format: date-time
750
+ * @description Response generation time (RFC 3339).
751
+ */
752
+ generatedAt?: string;
844
753
  /** Format: date-time */
845
754
  windowStart: string;
846
755
  /** Format: date-time */
@@ -853,6 +762,10 @@ export interface components {
853
762
  };
854
763
  };
855
764
  DashboardProductivityHistoryDto: {
765
+ /** Format: uuid */
766
+ workspaceId: string;
767
+ /** @enum {string} */
768
+ bucket: "day" | "week" | "month";
856
769
  buckets: {
857
770
  /** Format: date-time */
858
771
  bucketStart: string;
@@ -1168,86 +1081,6 @@ export interface components {
1168
1081
  items: components["schemas"]["NotificationDto"][];
1169
1082
  total: number;
1170
1083
  };
1171
- ReviewQueueItemDto: {
1172
- id: string;
1173
- client: string;
1174
- project: string;
1175
- workflows: ("greenfield" | "brownfield")[];
1176
- /** Format: date-time */
1177
- submittedAt: string;
1178
- reviewer: string | null;
1179
- /** @enum {string} */
1180
- status: "pending" | "in_review" | "approved" | "changes_requested";
1181
- /** @enum {string} */
1182
- priority: "high" | "medium" | "low";
1183
- };
1184
- AdminDashboardDto: {
1185
- queue: components["schemas"]["ReviewQueueItemDto"][];
1186
- reviewers: string[];
1187
- };
1188
- PatchAdminReviewBodyDto: {
1189
- /** @enum {string} */
1190
- status?: "pending" | "in_review" | "approved" | "changes_requested";
1191
- reviewer?: string;
1192
- /** @enum {string} */
1193
- priority?: "high" | "medium" | "low";
1194
- };
1195
- CommentDto: {
1196
- id: string;
1197
- sectionId: string;
1198
- author: string;
1199
- text: string;
1200
- /** Format: date-time */
1201
- timestamp: string;
1202
- };
1203
- AdminCommentBodyDto: {
1204
- text: string;
1205
- };
1206
- SectionDecisionBodyDto: {
1207
- /** @enum {string} */
1208
- decision: "pending" | "approved" | "changes_requested" | "rejected";
1209
- };
1210
- PricingLineDto: {
1211
- id: string;
1212
- label: string;
1213
- rate: number;
1214
- hours: number;
1215
- };
1216
- PricingUpdateBodyDto: {
1217
- items: {
1218
- id: string;
1219
- rate: number;
1220
- hours: number;
1221
- }[];
1222
- };
1223
- DeploymentPlanDto: {
1224
- startDate: string;
1225
- endDate: string;
1226
- milestones: string[];
1227
- };
1228
- ReviewSectionDto: {
1229
- id: string;
1230
- label: string;
1231
- detail: string;
1232
- /** @enum {string} */
1233
- decision: "pending" | "approved" | "changes_requested" | "rejected";
1234
- comments: components["schemas"]["CommentDto"][];
1235
- };
1236
- ReviewSubmissionDto: {
1237
- id: string;
1238
- client: string;
1239
- project: string;
1240
- workflows: ("greenfield" | "brownfield")[];
1241
- /** @enum {string} */
1242
- status: "pending" | "in_review" | "approved" | "changes_requested";
1243
- isResubmission: boolean;
1244
- context: {
1245
- text: string;
1246
- }[];
1247
- sections: components["schemas"]["ReviewSectionDto"][];
1248
- pricing: components["schemas"]["PricingLineDto"][];
1249
- deployment: components["schemas"]["DeploymentPlanDto"];
1250
- };
1251
1084
  EffectiveTaskRowDto: {
1252
1085
  id: string;
1253
1086
  name: string;
@@ -1338,8 +1171,6 @@ export interface components {
1338
1171
  WorkspaceId: string;
1339
1172
  RepoId: string;
1340
1173
  ProjectId: string;
1341
- ReviewId: string;
1342
- SectionId: string;
1343
1174
  NotificationId: string;
1344
1175
  };
1345
1176
  requestBodies: never;
@@ -1399,17 +1230,6 @@ export type ProjectDto = components['schemas']['ProjectDto'];
1399
1230
  export type ProjectPatchDto = components['schemas']['ProjectPatchDto'];
1400
1231
  export type NotificationDto = components['schemas']['NotificationDto'];
1401
1232
  export type NotificationListDto = components['schemas']['NotificationListDto'];
1402
- export type ReviewQueueItemDto = components['schemas']['ReviewQueueItemDto'];
1403
- export type AdminDashboardDto = components['schemas']['AdminDashboardDto'];
1404
- export type PatchAdminReviewBodyDto = components['schemas']['PatchAdminReviewBodyDto'];
1405
- export type CommentDto = components['schemas']['CommentDto'];
1406
- export type AdminCommentBodyDto = components['schemas']['AdminCommentBodyDto'];
1407
- export type SectionDecisionBodyDto = components['schemas']['SectionDecisionBodyDto'];
1408
- export type PricingLineDto = components['schemas']['PricingLineDto'];
1409
- export type PricingUpdateBodyDto = components['schemas']['PricingUpdateBodyDto'];
1410
- export type DeploymentPlanDto = components['schemas']['DeploymentPlanDto'];
1411
- export type ReviewSectionDto = components['schemas']['ReviewSectionDto'];
1412
- export type ReviewSubmissionDto = components['schemas']['ReviewSubmissionDto'];
1413
1233
  export type EffectiveTaskRowDto = components['schemas']['EffectiveTaskRowDto'];
1414
1234
  export type EffectivePhaseTasksBlockDto = components['schemas']['EffectivePhaseTasksBlockDto'];
1415
1235
  export type AiStrategyRecommendBodyDto = components['schemas']['AiStrategyRecommendBodyDto'];
@@ -1427,8 +1247,6 @@ export type ResponseForbidden = components['responses']['Forbidden'];
1427
1247
  export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
1428
1248
  export type ParameterRepoId = components['parameters']['RepoId'];
1429
1249
  export type ParameterProjectId = components['parameters']['ProjectId'];
1430
- export type ParameterReviewId = components['parameters']['ReviewId'];
1431
- export type ParameterSectionId = components['parameters']['SectionId'];
1432
1250
  export type ParameterNotificationId = components['parameters']['NotificationId'];
1433
1251
  export type $defs = Record<string, never>;
1434
1252
  export interface operations {
@@ -1826,6 +1644,18 @@ export interface operations {
1826
1644
  "application/json": components["schemas"]["DashboardProductivityDto"];
1827
1645
  };
1828
1646
  };
1647
+ /** @description Invalid query parameters */
1648
+ 400: {
1649
+ headers: {
1650
+ [name: string]: unknown;
1651
+ };
1652
+ content: {
1653
+ "application/json": {
1654
+ /** @example invalid_query */
1655
+ error: string;
1656
+ };
1657
+ };
1658
+ };
1829
1659
  401: components["responses"]["Unauthorized"];
1830
1660
  };
1831
1661
  };
@@ -1856,193 +1686,19 @@ export interface operations {
1856
1686
  "application/json": components["schemas"]["DashboardProductivityHistoryDto"];
1857
1687
  };
1858
1688
  };
1859
- 401: components["responses"]["Unauthorized"];
1860
- };
1861
- };
1862
- listAdminReviews: {
1863
- parameters: {
1864
- query?: {
1865
- status?: string;
1866
- priority?: string;
1867
- reviewer?: string;
1868
- };
1869
- header?: never;
1870
- path?: never;
1871
- cookie?: never;
1872
- };
1873
- requestBody?: never;
1874
- responses: {
1875
- /** @description Queue and reviewer list */
1876
- 200: {
1877
- headers: {
1878
- [name: string]: unknown;
1879
- };
1880
- content: {
1881
- "application/json": components["schemas"]["AdminDashboardDto"];
1882
- };
1883
- };
1884
- 401: components["responses"]["Unauthorized"];
1885
- 403: components["responses"]["Forbidden"];
1886
- };
1887
- };
1888
- getAdminReview: {
1889
- parameters: {
1890
- query?: never;
1891
- header?: never;
1892
- path: {
1893
- id: components["parameters"]["ReviewId"];
1894
- };
1895
- cookie?: never;
1896
- };
1897
- requestBody?: never;
1898
- responses: {
1899
- /** @description Review detail */
1900
- 200: {
1901
- headers: {
1902
- [name: string]: unknown;
1903
- };
1904
- content: {
1905
- "application/json": components["schemas"]["ReviewSubmissionDto"];
1906
- };
1907
- };
1908
- 401: components["responses"]["Unauthorized"];
1909
- 403: components["responses"]["Forbidden"];
1910
- };
1911
- };
1912
- patchAdminReview: {
1913
- parameters: {
1914
- query?: never;
1915
- header?: never;
1916
- path: {
1917
- id: components["parameters"]["ReviewId"];
1918
- };
1919
- cookie?: never;
1920
- };
1921
- requestBody: {
1922
- content: {
1923
- "application/json": components["schemas"]["PatchAdminReviewBodyDto"];
1924
- };
1925
- };
1926
- responses: {
1927
- /** @description Updated review */
1928
- 200: {
1929
- headers: {
1930
- [name: string]: unknown;
1931
- };
1932
- content: {
1933
- "application/json": components["schemas"]["ReviewSubmissionDto"];
1934
- };
1935
- };
1936
- 401: components["responses"]["Unauthorized"];
1937
- 403: components["responses"]["Forbidden"];
1938
- };
1939
- };
1940
- postAdminReviewComment: {
1941
- parameters: {
1942
- query?: never;
1943
- header?: never;
1944
- path: {
1945
- id: components["parameters"]["ReviewId"];
1946
- sectionId: components["parameters"]["SectionId"];
1947
- };
1948
- cookie?: never;
1949
- };
1950
- requestBody: {
1951
- content: {
1952
- "application/json": components["schemas"]["AdminCommentBodyDto"];
1953
- };
1954
- };
1955
- responses: {
1956
- /** @description Created comment */
1957
- 200: {
1689
+ /** @description Invalid query parameters */
1690
+ 400: {
1958
1691
  headers: {
1959
1692
  [name: string]: unknown;
1960
1693
  };
1961
1694
  content: {
1962
- "application/json": components["schemas"]["CommentDto"];
1963
- };
1964
- };
1965
- 401: components["responses"]["Unauthorized"];
1966
- 403: components["responses"]["Forbidden"];
1967
- };
1968
- };
1969
- putAdminReviewSectionDecision: {
1970
- parameters: {
1971
- query?: never;
1972
- header?: never;
1973
- path: {
1974
- id: components["parameters"]["ReviewId"];
1975
- sectionId: components["parameters"]["SectionId"];
1976
- };
1977
- cookie?: never;
1978
- };
1979
- requestBody: {
1980
- content: {
1981
- "application/json": components["schemas"]["SectionDecisionBodyDto"];
1982
- };
1983
- };
1984
- responses: {
1985
- /** @description Saved */
1986
- 204: {
1987
- headers: {
1988
- [name: string]: unknown;
1989
- };
1990
- content?: never;
1991
- };
1992
- 401: components["responses"]["Unauthorized"];
1993
- 403: components["responses"]["Forbidden"];
1994
- };
1995
- };
1996
- putAdminReviewPricing: {
1997
- parameters: {
1998
- query?: never;
1999
- header?: never;
2000
- path: {
2001
- id: components["parameters"]["ReviewId"];
2002
- };
2003
- cookie?: never;
2004
- };
2005
- requestBody: {
2006
- content: {
2007
- "application/json": components["schemas"]["PricingUpdateBodyDto"];
2008
- };
2009
- };
2010
- responses: {
2011
- /** @description Saved */
2012
- 204: {
2013
- headers: {
2014
- [name: string]: unknown;
2015
- };
2016
- content?: never;
2017
- };
2018
- 401: components["responses"]["Unauthorized"];
2019
- 403: components["responses"]["Forbidden"];
2020
- };
2021
- };
2022
- putAdminReviewDeployment: {
2023
- parameters: {
2024
- query?: never;
2025
- header?: never;
2026
- path: {
2027
- id: components["parameters"]["ReviewId"];
2028
- };
2029
- cookie?: never;
2030
- };
2031
- requestBody: {
2032
- content: {
2033
- "application/json": components["schemas"]["DeploymentPlanDto"];
2034
- };
2035
- };
2036
- responses: {
2037
- /** @description Saved */
2038
- 204: {
2039
- headers: {
2040
- [name: string]: unknown;
1695
+ "application/json": {
1696
+ /** @example invalid_query */
1697
+ error: string;
1698
+ };
2041
1699
  };
2042
- content?: never;
2043
1700
  };
2044
1701
  401: components["responses"]["Unauthorized"];
2045
- 403: components["responses"]["Forbidden"];
2046
1702
  };
2047
1703
  };
2048
1704
  getCompanyProfile: {