@thinkai/tai-api-contract 2.12.0 → 2.14.0

package/src/generated/openapi.ts

@@ -586,6 +586,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/github/user-authorize-url": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create GitHub user OAuth authorize URL
+         * @description Starts GitHub user OAuth for org/account picker. Workspace admin only. After callback, SPA opens account picker with `?gh=account_picker&session=…`.
+         */
+        post: operations["postGithubUserAuthorizeUrl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/github/connectable-accounts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List connectable GitHub accounts from user OAuth session
+         * @description Returns org/user accounts from a completed user OAuth picker session. Session must belong to the caller and workspace.
+         */
+        get: operations["getGithubConnectableAccounts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/github/connect-by-org": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Link GitHub App installation by org or user account
+         * @description Server-side link when the ThinkAI GitHub App is already installed on the selected account. Returns `needs_oauth` when install redirect is required. Workspace admin only.
+         */
+        post: operations["postGithubConnectByOrg"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/refresh": {
         parameters: {
             query?: never;
@@ -711,6 +771,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/integrations/github/user-oauth/callback": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * GitHub user OAuth callback
+         * @description Public callback for GitHub user OAuth (org/account picker flow). Exchanges code, builds connectable-accounts snapshot, redirects SPA with `?gh=account_picker&session=…`.
+         */
+        get: operations["getGithubUserOauthCallback"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/integrations/github/webhook": {
         parameters: {
             query?: never;
@@ -1665,6 +1745,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/absences": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List absence records
+         * @description Returns time-off/absence records sourced from connected HRIS providers (e.g. Personio) for the given date window. Requires workspace membership.
+         */
+        get: operations["listWorkspaceAbsences"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/hris/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * HRIS sync status
+         * @description Returns the last sync status for every HRIS provider connected to the workspace. Returns an empty `statuses` array when no HRIS source has been synced yet. Requires workspace membership.
+         */
+        get: operations["getHrisSyncStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/hris/sync": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Trigger manual HRIS sync
+         * @description Manually triggers an HRIS sync for the workspace. Runs synchronously and returns the result. Requires editor role (same permission level as org-chart writes). Returns 422 when no HRIS source is configured.
+         */
+        post: operations["triggerHrisSync"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -2462,6 +2602,48 @@ export interface components {
             url: string;
             state: string;
         };
+        GithubUserAuthorizeUrlRequestDto: {
+            returnPath?: string;
+        };
+        GithubUserAuthorizeUrlResponseDto: {
+            /** Format: uri */
+            url: string;
+            state: string;
+        };
+        GithubConnectableAccountDto: {
+            login: string;
+            /** @enum {string} */
+            type: "Organization" | "User";
+            /** Format: uri */
+            avatarUrl?: string | null;
+            /** @description Whether the ThinkAI GitHub App is already installed on this account. */
+            appInstalled: boolean;
+        };
+        GithubConnectableAccountsResponseDto: {
+            accounts: components["schemas"]["GithubConnectableAccountDto"][];
+        };
+        GithubConnectByOrgRequestDto: {
+            accountLogin: string;
+            /** @enum {string} */
+            accountType: "Organization" | "User";
+            session: string;
+        };
+        GithubConnectByOrgConnectedDto: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            outcome: "connected";
+            status: components["schemas"]["GithubInstallationStatusDto"];
+        };
+        GithubConnectByOrgNeedsOAuthDto: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            outcome: "needs_oauth";
+        };
+        GithubConnectByOrgResponseDto: components["schemas"]["GithubConnectByOrgConnectedDto"] | components["schemas"]["GithubConnectByOrgNeedsOAuthDto"];
         AIReadinessDto: {
             currentUsage: string;
             tools: string[];
@@ -3215,6 +3397,57 @@ export interface components {
                 [key: string]: unknown;
             } | null;
         };
+        WorkspaceAbsenceDto: {
+            /** @description HRIS provider that sourced this record (e.g. 'personio', 'zenhr'). */
+            source: string;
+            /** Format: email */
+            employeeEmail: string;
+            absenceType: string;
+            /** Format: date */
+            startDate: string;
+            /** Format: date */
+            endDate: string;
+            halfDayStart: boolean;
+            halfDayEnd: boolean;
+            /** @enum {string} */
+            status: "approved" | "pending" | "rejected";
+        };
+        WorkspaceAbsenceListDto: {
+            absences: components["schemas"]["WorkspaceAbsenceDto"][];
+            /**
+             * Format: date-time
+             * @description ISO timestamp of the most recent successful HRIS sync, or null if never synced.
+             */
+            syncedAt: string | null;
+        };
+        HrisSyncStatusDto: {
+            /** @description Provider identifier (e.g. 'personio', 'zenhr'). */
+            provider: string;
+            /** Format: date-time */
+            lastSyncAt: string | null;
+            /** @enum {string} */
+            status: "ok" | "error" | "never";
+            lastError?: string | null;
+        };
+        HrisSyncStatusListDto: {
+            statuses: components["schemas"]["HrisSyncStatusDto"][];
+        };
+        HrisTriggerSyncResultDto: {
+            /** @enum {string} */
+            status: "ok" | "skipped" | "error";
+            /** @description Stable machine-readable code (e.g. 'no_personio_source', 'hris_sync_failed'). */
+            code?: string;
+            /** @description Number of employees synced (present when status = 'ok'). */
+            employeeCount?: number;
+            /** @description Number of absence records synced (present when status = 'ok'). */
+            absenceCount?: number;
+            /** @description Wall-clock duration of the sync in milliseconds (present when status = 'ok'). */
+            durationMs?: number;
+            /** @description Machine-readable reason for a skipped sync (e.g. 'no_personio_source'). */
+            reason?: string;
+            /** @description Error message when status = 'error'. */
+            error?: string;
+        };
         ActivityLogPageDto: components["schemas"]["PageMetaDto"] & {
             items: components["schemas"]["ActivityLogEntryDto"][];
         };
@@ -3362,6 +3595,14 @@ export type GithubPendingApprovalDto = components['schemas']['GithubPendingAppro
 export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
 export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
 export type GithubInstallUrlResponseDto = components['schemas']['GithubInstallUrlResponseDto'];
+export type GithubUserAuthorizeUrlRequestDto = components['schemas']['GithubUserAuthorizeUrlRequestDto'];
+export type GithubUserAuthorizeUrlResponseDto = components['schemas']['GithubUserAuthorizeUrlResponseDto'];
+export type GithubConnectableAccountDto = components['schemas']['GithubConnectableAccountDto'];
+export type GithubConnectableAccountsResponseDto = components['schemas']['GithubConnectableAccountsResponseDto'];
+export type GithubConnectByOrgRequestDto = components['schemas']['GithubConnectByOrgRequestDto'];
+export type GithubConnectByOrgConnectedDto = components['schemas']['GithubConnectByOrgConnectedDto'];
+export type GithubConnectByOrgNeedsOAuthDto = components['schemas']['GithubConnectByOrgNeedsOAuthDto'];
+export type GithubConnectByOrgResponseDto = components['schemas']['GithubConnectByOrgResponseDto'];
 export type AiReadinessDto = components['schemas']['AIReadinessDto'];
 export type AiMaturityResultDto = components['schemas']['AiMaturityResultDto'];
 export type TechCategoryDto = components['schemas']['TechCategoryDto'];
@@ -3444,6 +3685,11 @@ export type PatchRepoArchiveResponseDto = components['schemas']['PatchRepoArchiv
 export type ActivityLogEventTypeDto = components['schemas']['ActivityLogEventTypeDto'];
 export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
 export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
+export type WorkspaceAbsenceDto = components['schemas']['WorkspaceAbsenceDto'];
+export type WorkspaceAbsenceListDto = components['schemas']['WorkspaceAbsenceListDto'];
+export type HrisSyncStatusDto = components['schemas']['HrisSyncStatusDto'];
+export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto'];
+export type HrisTriggerSyncResultDto = components['schemas']['HrisTriggerSyncResultDto'];
 export type ActivityLogPageDto = components['schemas']['ActivityLogPageDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
@@ -5045,6 +5291,174 @@ export interface operations {
             };
         };
     };
+    postGithubUserAuthorizeUrl: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["GithubUserAuthorizeUrlRequestDto"];
+            };
+        };
+        responses: {
+            /** @description User OAuth authorize URL + signed state */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubUserAuthorizeUrlResponseDto"];
+                };
+            };
+            /** @description Request validation failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description GitHub user OAuth not configured */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getGithubConnectableAccounts: {
+        parameters: {
+            query: {
+                session: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Connectable accounts snapshot */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubConnectableAccountsResponseDto"];
+                };
+            };
+            /** @description Missing or invalid session */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    postGithubConnectByOrg: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GithubConnectByOrgRequestDto"];
+            };
+        };
+        responses: {
+            /** @description Connect result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubConnectByOrgResponseDto"];
+                };
+            };
+            /** @description Invalid session or account */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description GitHub installation already linked to another workspace */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "installation_already_linked"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description GitHub API error */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     refreshWorkspaceAiTool: {
         parameters: {
             query?: never;
@@ -5302,6 +5716,47 @@ export interface operations {
             };
         };
     };
+    getGithubUserOauthCallback: {
+        parameters: {
+            query: {
+                state: string;
+                code?: string;
+                error?: string;
+                error_description?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Redirect to ThinkAI SPA with account picker session or error */
+            302: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Workspace store not configured */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description SPA origin or GitHub OAuth configuration missing */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     postGithubWebhook: {
         parameters: {
             query?: never;
@@ -7620,4 +8075,149 @@ export interface operations {
             };
         };
     };
+    listWorkspaceAbsences: {
+        parameters: {
+            query?: {
+                /** @description Start of date window (ISO YYYY-MM-DD). Defaults to today. */
+                from?: string;
+                /** @description End of date window (ISO YYYY-MM-DD). Defaults to 90 days from today. */
+                to?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Absence list with last sync timestamp */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "absences": [
+                     *         {
+                     *           "source": "personio",
+                     *           "employeeEmail": "alice@example.com",
+                     *           "absenceType": "Vacation",
+                     *           "startDate": "2025-07-01",
+                     *           "endDate": "2025-07-05",
+                     *           "halfDayStart": false,
+                     *           "halfDayEnd": false,
+                     *           "status": "approved"
+                     *         }
+                     *       ],
+                     *       "syncedAt": "2025-06-30T08:00:00.000Z"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["WorkspaceAbsenceListDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getHrisSyncStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sync status list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "statuses": [
+                     *         {
+                     *           "provider": "personio",
+                     *           "lastSyncAt": "2025-06-30T08:00:00.000Z",
+                     *           "status": "ok"
+                     *         }
+                     *       ]
+                     *     }
+                     */
+                    "application/json": components["schemas"]["HrisSyncStatusListDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    triggerHrisSync: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sync completed successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "ok",
+                     *       "employeeCount": 42,
+                     *       "absenceCount": 7,
+                     *       "durationMs": 1234
+                     *     }
+                     */
+                    "application/json": components["schemas"]["HrisTriggerSyncResultDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description No HRIS source configured for this workspace */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "skipped",
+                     *       "code": "no_personio_source",
+                     *       "reason": "no_personio_source"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["HrisTriggerSyncResultDto"];
+                };
+            };
+            /** @description Sync failed (Personio API error, decryption failure, etc.) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "code": "hris_sync_failed",
+                     *       "error": "Personio employees API 401"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["HrisTriggerSyncResultDto"];
+                };
+            };
+        };
+    };
 }