@thinkai/tai-api-contract 2.58.0-pr.901.7f05b4b4 → 2.58.1-pr.901.538cc170

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.
@@ -1038,7 +1038,7 @@ export interface paths {
1038
1038
  put?: never;
1039
1039
  /**
1040
1040
  * Create GitHub App installation URL
1041
- * @description Creates a GitHub App installation URL scoped to the workspace and caller. Body is optional; when omitted, defaults to `/onboarding/integrations` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
1041
+ * @description Creates a GitHub App installation URL scoped to the workspace and caller. Default intent `connect` installs ThinkAI Platform Insights (read). Intent `enable_fixes` installs ThinkAI Platform Automations (write) for the Insights installation identified by `installationId`. Body is optional; when omitted, defaults to `/onboarding/integrations` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
1042
1042
  */
1043
1043
  post: operations["postGithubInstallUrl"];
1044
1044
  delete?: never;
@@ -1047,6 +1047,46 @@ export interface paths {
1047
1047
  patch?: never;
1048
1048
  trace?: never;
1049
1049
  };
1050
+ "/workspaces/{workspaceId}/integrations/github/installations/{installationId}/automated-fixes/enable": {
1051
+ parameters: {
1052
+ query?: never;
1053
+ header?: never;
1054
+ path?: never;
1055
+ cookie?: never;
1056
+ };
1057
+ get?: never;
1058
+ put?: never;
1059
+ /**
1060
+ * Enable automated fixes for a GitHub installation
1061
+ * @description Workspace-level enable for automated fixes on an Insights (read) installation. If an Automations (write) installation is already linked, flips `automatedFixesEnabled` without reinstalling. Otherwise returns `outcome: needs_install` so the client can call install-url with intent=enable_fixes.
1062
+ */
1063
+ post: operations["postGithubAutomatedFixesEnable"];
1064
+ delete?: never;
1065
+ options?: never;
1066
+ head?: never;
1067
+ patch?: never;
1068
+ trace?: never;
1069
+ };
1070
+ "/workspaces/{workspaceId}/integrations/github/installations/{installationId}/automated-fixes": {
1071
+ parameters: {
1072
+ query?: never;
1073
+ header?: never;
1074
+ path?: never;
1075
+ cookie?: never;
1076
+ };
1077
+ get?: never;
1078
+ put?: never;
1079
+ post?: never;
1080
+ /**
1081
+ * Disable automated fixes for a GitHub installation
1082
+ * @description Workspace-level disable. Clears `automatedFixesEnabled` but keeps the linked Automations write installation id so re-enable does not require reinstall. Does not uninstall the Automations app from GitHub.
1083
+ */
1084
+ delete: operations["deleteGithubAutomatedFixes"];
1085
+ options?: never;
1086
+ head?: never;
1087
+ patch?: never;
1088
+ trace?: never;
1089
+ };
1050
1090
  "/workspaces/{workspaceId}/integrations/github/user-authorize-url": {
1051
1091
  parameters: {
1052
1092
  query?: never;
@@ -4259,7 +4299,7 @@ export interface components {
4259
4299
  permissionsUpgradeRequired: boolean;
4260
4300
  /** @description True when installation grants read permissions for repository analysis (contents, metadata, pull requests, and members for org installs). */
4261
4301
  corePermissionsOk: boolean;
4262
- /** @description True when installation grants write permissions required for automated fix PRs. */
4302
+ /** @description True when automated fixes are enabled and the linked Automations (write) installation grants write permissions required for fix PRs. */
4263
4303
  writePermissionsOk: boolean;
4264
4304
  /** @description Alias for `!writePermissionsOk`. */
4265
4305
  writePermissionsUpgradeRequired: boolean;
@@ -4271,6 +4311,19 @@ export interface components {
4271
4311
  upgradeMessage?: string | null;
4272
4312
  /** @description Human-readable summary for UI when write permissions are missing. */
4273
4313
  writeUpgradeMessage?: string | null;
4314
+ /** @description True when this workspace has enabled automated fixes for this Insights (read) installation and linked a ThinkAI Platform Automations (write) installation. */
4315
+ automatedFixesEnabled: boolean;
4316
+ /** @description True when an Automations (write) GitHub App installation is linked. */
4317
+ writeAppInstalled: boolean;
4318
+ /** @description GitHub installation id for the Automations (write) app, when linked. */
4319
+ writeInstallationId?: string | null;
4320
+ /**
4321
+ * Format: uri
4322
+ * @description GitHub settings URL for the Automations (write) installation.
4323
+ */
4324
+ writeManageUrl?: string | null;
4325
+ /** @description True when the Automations app is configured and automated fixes are not yet enabled for this installation (UI may show Enable automated fixes). */
4326
+ canEnableAutomatedFixes: boolean;
4274
4327
  };
4275
4328
  GithubPendingApprovalDto: {
4276
4329
  /**
@@ -4389,12 +4442,28 @@ export interface components {
4389
4442
  * @description SPA origin to redirect back to after OAuth; must match server spaOrigins allowlist.
4390
4443
  */
4391
4444
  spaOrigin?: string;
4445
+ /**
4446
+ * @description connect installs ThinkAI Platform Insights (read). enable_fixes installs ThinkAI Platform Automations (write) for the Insights installation identified by installationId.
4447
+ * @enum {string}
4448
+ */
4449
+ intent?: "connect" | "enable_fixes";
4450
+ /** @description Insights (read) installation id required when intent is enable_fixes. */
4451
+ installationId?: string;
4392
4452
  };
4393
4453
  GithubInstallUrlResponseDto: {
4394
4454
  /** Format: uri */
4395
4455
  url: string;
4396
4456
  state: string;
4397
4457
  };
4458
+ GithubAutomatedFixesEnableResponseDto: {
4459
+ /**
4460
+ * @description enabled — write app already linked and flag flipped; needs_install — client should call install-url with intent=enable_fixes.
4461
+ * @enum {string}
4462
+ */
4463
+ outcome: "enabled" | "needs_install";
4464
+ /** @description Present when outcome is enabled. */
4465
+ status?: components["schemas"]["GithubInstallationStatusDto"];
4466
+ };
4398
4467
  GithubUserAuthorizeUrlRequestDto: {
4399
4468
  returnPath?: string;
4400
4469
  /**
@@ -5882,6 +5951,7 @@ export type GithubActionsEnableResponseDto = components['schemas']['GithubAction
5882
5951
  export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
5883
5952
  export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
5884
5953
  export type GithubInstallUrlResponseDto = components['schemas']['GithubInstallUrlResponseDto'];
5954
+ export type GithubAutomatedFixesEnableResponseDto = components['schemas']['GithubAutomatedFixesEnableResponseDto'];
5885
5955
  export type GithubUserAuthorizeUrlRequestDto = components['schemas']['GithubUserAuthorizeUrlRequestDto'];
5886
5956
  export type GithubUserAuthorizeUrlResponseDto = components['schemas']['GithubUserAuthorizeUrlResponseDto'];
5887
5957
  export type GithubConnectableAccountDto = components['schemas']['GithubConnectableAccountDto'];
@@ -8980,6 +9050,90 @@ export interface operations {
8980
9050
  "application/json": components["schemas"]["ErrorMessageDto"];
8981
9051
  };
8982
9052
  };
9053
+ /** @description Requested GitHub App is not configured */
9054
+ 503: {
9055
+ headers: {
9056
+ [name: string]: unknown;
9057
+ };
9058
+ content: {
9059
+ "application/json": components["schemas"]["ErrorMessageDto"];
9060
+ };
9061
+ };
9062
+ };
9063
+ };
9064
+ postGithubAutomatedFixesEnable: {
9065
+ parameters: {
9066
+ query?: never;
9067
+ header?: never;
9068
+ path: {
9069
+ workspaceId: components["parameters"]["WorkspaceId"];
9070
+ installationId: string;
9071
+ };
9072
+ cookie?: never;
9073
+ };
9074
+ requestBody?: never;
9075
+ responses: {
9076
+ /** @description Enable result */
9077
+ 200: {
9078
+ headers: {
9079
+ [name: string]: unknown;
9080
+ };
9081
+ content: {
9082
+ "application/json": components["schemas"]["GithubAutomatedFixesEnableResponseDto"];
9083
+ };
9084
+ };
9085
+ 401: components["responses"]["Unauthorized"];
9086
+ 403: components["responses"]["Forbidden"];
9087
+ /** @description Workspace or installation not found */
9088
+ 404: {
9089
+ headers: {
9090
+ [name: string]: unknown;
9091
+ };
9092
+ content: {
9093
+ "application/json": components["schemas"]["ErrorMessageDto"];
9094
+ };
9095
+ };
9096
+ /** @description Automations GitHub App not configured */
9097
+ 503: {
9098
+ headers: {
9099
+ [name: string]: unknown;
9100
+ };
9101
+ content: {
9102
+ "application/json": components["schemas"]["ErrorMessageDto"];
9103
+ };
9104
+ };
9105
+ };
9106
+ };
9107
+ deleteGithubAutomatedFixes: {
9108
+ parameters: {
9109
+ query?: never;
9110
+ header?: never;
9111
+ path: {
9112
+ workspaceId: components["parameters"]["WorkspaceId"];
9113
+ installationId: string;
9114
+ };
9115
+ cookie?: never;
9116
+ };
9117
+ requestBody?: never;
9118
+ responses: {
9119
+ /** @description Automated fixes disabled (or already disabled) */
9120
+ 204: {
9121
+ headers: {
9122
+ [name: string]: unknown;
9123
+ };
9124
+ content?: never;
9125
+ };
9126
+ 401: components["responses"]["Unauthorized"];
9127
+ 403: components["responses"]["Forbidden"];
9128
+ /** @description Workspace or installation not found */
9129
+ 404: {
9130
+ headers: {
9131
+ [name: string]: unknown;
9132
+ };
9133
+ content: {
9134
+ "application/json": components["schemas"]["ErrorMessageDto"];
9135
+ };
9136
+ };
8983
9137
  };
8984
9138
  };
8985
9139
  postGithubUserAuthorizeUrl: {