@thinkai/tai-api-contract 2.187.0 → 2.189.0

package/src/generated/openapi.ts

@@ -3344,6 +3344,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/rules-skills/validate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Validate agent rules and skills for a repository
+         * @description Clones the connected GitHub repository via the workspace GitHub App installation and runs the shared Rules & Skills validate engine (structural + soft quality). Assessed tools come from the latest **succeeded** readiness scan (`agent_tool_assessed`: `cursor` | `claude-code` | `both`). Returns draft `proposedFiles` for review (not committed). Workspace member auth; write permissions are not required for validate-only.
+         */
+        post: operations["postRulesSkillsValidate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/rules-skills/pull-requests": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Open a Rules & Skills remediation pull request
+         * @description Applies `proposedFiles` (or a future create-mode session) onto a non-default branch via the Automations GitHub App installation and opens a pull request. Never pushes to the default branch. PR title/body identify the change as platform-generated and link back to `/agentic-foundation/rules-skills`. Requires workspace editor or admin. Same write-permission gate as readiness fixes.
+         */
+        post: operations["postRulesSkillsPullRequest"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/issues/{issueId}/fix-guide": {
         parameters: {
             query?: never;
@@ -6078,6 +6118,36 @@ export interface components {
             /** @description PagerDuty user email when known from the last successful verify. */
             userEmail?: string;
         };
+        /** @description Sentry incident and release source for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. Requires an organization slug and an auth token with `org:read`, `event:read`, and `project:read`. Issues map to incident events and releases with a commit or environment map to deployment events. */
+        SentrySourceDto: {
+            /** @enum {string} */
+            type: "sentry";
+            /** @description Sentry organization slug (the `{slug}` in `sentry.io/organizations/{slug}/`). */
+            orgSlug: string;
+            /** @description Sentry auth token (organization or internal integration token, write-only on PUT). */
+            token: string;
+            /** @description Optional API base URL for self-hosted Sentry. Default `https://sentry.io/api/0`. */
+            baseUrl?: string;
+            /** @description Optional project slug. When set, only that project's issues and releases are ingested. */
+            projectSlug?: string;
+            /** @description Optional organization display name from a successful connection test (echo-after-test). */
+            orgName?: string;
+        };
+        /** @description Redacted Sentry source returned by `GET /workspaces/{workspaceId}/config`. Raw token is never returned. */
+        SentrySourceConfigDto: {
+            /** @enum {string} */
+            type: "sentry";
+            /** @description Whether an auth token is stored for this workspace. */
+            hasToken: boolean;
+            /** @description Configured Sentry organization slug. */
+            orgSlug: string;
+            /** @description Configured API base URL override, when set. */
+            baseUrl?: string;
+            /** @description Configured project filter, when set. */
+            projectSlug?: string;
+            /** @description Sentry organization name when known from the last successful verify. */
+            orgName?: string;
+        };
         /** @description Jira Cloud source for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. Uses Atlassian Cloud email + API token (Basic auth). Provide `apiToken` (preferred) or legacy write-only `api_key`; the server normalizes `api_key` to `apiToken` on write. */
         JiraSourceDto: {
             /** @enum {string} */
@@ -6202,7 +6272,7 @@ export interface components {
             topics?: components["schemas"]["CodeWikiGuidanceTopicDto"][];
         };
         WorkspaceConfigDto: {
-            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"])[];
+            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"]["SentrySourceConfigDto"] | components["schemas"]["JiraSourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
             orgChart?: components["schemas"]["ScoringOrgChartDto"] | null;
             /** @enum {string|null} */
             region?: "us" | "eu" | "me" | null;
@@ -6325,7 +6395,7 @@ export interface components {
             accountName?: string;
             /** @description Present for New Relic or Jira verify success — resolved account ID. */
             accountId?: string;
-            /** @description Present for Grafana or Datadog verify success — resolved organization name. */
+            /** @description Present for Grafana, Datadog, or Sentry verify success — resolved organization name. */
             orgName?: string;
             /** @description Present for Prometheus verify success — Alertmanager cluster name. */
             clusterName?: string;
@@ -9243,6 +9313,80 @@ export interface components {
             /** @description Required when the issue has unresolvedChoices. Must be one of those labels. Stored on the fix row and stated in the worker prompt. */
             patternChoice?: string;
         };
+        /**
+         * @description From the latest succeeded readiness scan (`agent_tool_assessed`). Never invent `both` without scan evidence.
+         * @enum {string}
+         */
+        RulesSkillsAssessedTools: "cursor" | "claude-code" | "both";
+        RulesSkillsValidateRequestDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @description Optional relative path prefixes limiting the validate walk. */
+            pathPrefixes?: string[];
+        };
+        RulesSkillsFindingDto: {
+            id: string;
+            /** @enum {string} */
+            kind: "structural" | "soft";
+            /** @enum {string} */
+            severity: "fail" | "warn";
+            code: string;
+            path: string;
+            message: string;
+            /** @description Empty when unmapped structural noise. */
+            criterionIds: ("A1" | "A2" | "A3" | "A3a" | "A3b" | "A3c" | "A11")[];
+        };
+        RulesSkillsSoftQualityCheckDto: {
+            code: string;
+            /** @enum {string} */
+            status: "pass" | "fail" | "warn" | "skip";
+            message?: string;
+            path?: string;
+        };
+        RulesSkillsSoftQualitySummaryDto: {
+            /** @description True when there are no soft-quality fail findings (warns allowed). */
+            passed: boolean;
+            failCount: number;
+            warnCount: number;
+            checks: components["schemas"]["RulesSkillsSoftQualityCheckDto"][];
+        };
+        RulesSkillsProposedFileDto: {
+            path: string;
+            /** @enum {string} */
+            action: "create" | "update" | "delete" | "rename";
+            /** @description Full file contents for create/update/rename target. */
+            content?: string;
+            /** @description Source path when action is rename. */
+            previousPath?: string;
+        };
+        RulesSkillsValidateResponseDto: {
+            assessedTools: components["schemas"]["RulesSkillsAssessedTools"];
+            findings: components["schemas"]["RulesSkillsFindingDto"][];
+            softQualitySummary: components["schemas"]["RulesSkillsSoftQualitySummaryDto"];
+            proposedFiles: components["schemas"]["RulesSkillsProposedFileDto"][];
+            /** @description Quiet-case note (e.g. empty tree under pathPrefixes). */
+            note?: string;
+        };
+        RulesSkillsOpenPullRequestRequestDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @enum {string} */
+            mode: "validate" | "create";
+            /**
+             * Format: uuid
+             * @description Reserved for Create-mode sessions; validate mode uses proposedFiles.
+             */
+            sessionId?: string;
+            proposedFiles?: components["schemas"]["RulesSkillsProposedFileDto"][];
+            title?: string;
+            body?: string;
+        };
+        RulesSkillsOpenPullRequestResponseDto: {
+            /** Format: uri */
+            prUrl: string;
+            prNumber: number;
+            branchName: string;
+        };
         PhaseRoleDto: {
             phase: string;
             /** @enum {string} */
@@ -12878,6 +13022,8 @@ export type SonarQubeRepoMappingValidateRowDto = components['schemas']['SonarQub
 export type SonarQubeRepoMappingsValidateResponseDto = components['schemas']['SonarQubeRepoMappingsValidateResponseDto'];
 export type PagerDutySourceDto = components['schemas']['PagerDutySourceDto'];
 export type PagerDutySourceConfigDto = components['schemas']['PagerDutySourceConfigDto'];
+export type SentrySourceDto = components['schemas']['SentrySourceDto'];
+export type SentrySourceConfigDto = components['schemas']['SentrySourceConfigDto'];
 export type JiraSourceDto = components['schemas']['JiraSourceDto'];
 export type JiraSourceConfigDto = components['schemas']['JiraSourceConfigDto'];
 export type AgentExecutionProviderDto = components['schemas']['AgentExecutionProviderDto'];
@@ -13132,6 +13278,15 @@ export type ReadinessFixGuideDto = components['schemas']['ReadinessFixGuideDto']
 export type FixRetryableErrorCode = components['schemas']['FixRetryableErrorCode'];
 export type FixNonRetryableErrorCode = components['schemas']['FixNonRetryableErrorCode'];
 export type CreateFixRequestBodyDto = components['schemas']['CreateFixRequestBodyDto'];
+export type RulesSkillsAssessedTools = components['schemas']['RulesSkillsAssessedTools'];
+export type RulesSkillsValidateRequestDto = components['schemas']['RulesSkillsValidateRequestDto'];
+export type RulesSkillsFindingDto = components['schemas']['RulesSkillsFindingDto'];
+export type RulesSkillsSoftQualityCheckDto = components['schemas']['RulesSkillsSoftQualityCheckDto'];
+export type RulesSkillsSoftQualitySummaryDto = components['schemas']['RulesSkillsSoftQualitySummaryDto'];
+export type RulesSkillsProposedFileDto = components['schemas']['RulesSkillsProposedFileDto'];
+export type RulesSkillsValidateResponseDto = components['schemas']['RulesSkillsValidateResponseDto'];
+export type RulesSkillsOpenPullRequestRequestDto = components['schemas']['RulesSkillsOpenPullRequestRequestDto'];
+export type RulesSkillsOpenPullRequestResponseDto = components['schemas']['RulesSkillsOpenPullRequestResponseDto'];
 export type PhaseRoleDto = components['schemas']['PhaseRoleDto'];
 export type SquadMemberDto = components['schemas']['SquadMemberDto'];
 export type CustomWorkStreamTaskDto = components['schemas']['CustomWorkStreamTaskDto'];
@@ -16207,7 +16362,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    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"])[];
+                    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"]["SentrySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
                 };
             };
         };
@@ -16261,7 +16416,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "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"];
+                "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"]["SentrySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"];
             };
         };
         responses: {
@@ -22868,6 +23023,134 @@ export interface operations {
             };
         };
     };
+    postRulesSkillsValidate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RulesSkillsValidateRequestDto"];
+            };
+        };
+        responses: {
+            /** @description Validation result with findings and draft proposed files */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RulesSkillsValidateResponseDto"];
+                };
+            };
+            /** @description Invalid body (e.g. malformed repoId) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found / not connected */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description No succeeded readiness scan for the repo (`code: readiness_scan_required`), or repository is not a GitHub-connected readiness repo. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Clone or GitHub App configuration failed */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    postRulesSkillsPullRequest: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RulesSkillsOpenPullRequestRequestDto"];
+            };
+        };
+        responses: {
+            /** @description Pull request created */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RulesSkillsOpenPullRequestResponseDto"];
+                };
+            };
+            /** @description Missing proposed files or invalid body (`code: proposed_files_required`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description GitHub installation lacks write permissions required for automated PRs */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubWritePermissionsRequiredErrorDto"];
+                };
+            };
+            /** @description GitHub installation permissions could not be verified, or PR create failed */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubPermissionsCheckFailedErrorDto"] | components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessIssueFixGuide: {
         parameters: {
             query?: never;