@thinkai/tai-api-contract 2.11.1 → 2.13.0

package/src/generated/openapi.ts

@@ -949,7 +949,12 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Archive (remove) or restore (re-add) a repository
+         * @description Set `archived: true` to soft-remove the repo (Inactive). Set `archived: false` to re-add a previously Inactive repo (Active). Re-add reuses the same `repo_id` row so historical scan foreign keys remain intact, and automatically enqueues a fresh readiness scan.
+         *     Returns `409` with `code: repo_scan_in_progress` if a scan is queued or running when archiving. Returns `409` with `code: repo_already_active` if re-adding a repo that is already Active.
+         */
+        patch: operations["patchReadinessRepo"];
         trace?: never;
     };
     "/workspaces/{workspaceId}/readiness/repos/{repoId}/runs": {
@@ -992,6 +997,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/activity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace activity log (paginated)
+         * @description Paginated, chronological feed of workspace-scoped lifecycle events: repository add/remove/re-add and GitHub integration add/remove. Inactive repos remain visible in this log. Filter by `eventType`, `actorUserId`, or date range (`since`/`until`).
+         */
+        get: operations["listWorkspaceActivity"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/score-history": {
         parameters: {
             query?: never;
@@ -1640,6 +1665,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 {
@@ -3120,6 +3205,130 @@ export interface components {
                 activeUsers: number;
             }[];
         };
+        PatchRepoArchiveBodyDto: {
+            /** @description `true` to soft-remove (Inactive). `false` to restore a previously Inactive repo (Active), which also enqueues a fresh readiness scan. */
+            archived: boolean;
+        };
+        PatchRepoArchiveResponseDto: {
+            /** Format: uuid */
+            repoId: string;
+            /**
+             * @description Current lifecycle status of the repository after the operation.
+             * @enum {string}
+             */
+            status: "Active" | "Inactive";
+            /**
+             * Format: uuid
+             * @description ID of the freshly enqueued readiness scan run (only present on re-add).
+             */
+            runId?: string | null;
+        };
+        /**
+         * @description Type of workspace lifecycle event.
+         * @enum {string}
+         */
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "config.cursor.added" | "config.cursor.updated" | "config.cursor.removed" | "config.cursor.platform_key_enabled" | "config.cursor.platform_key_disabled" | "config.claude.added" | "config.claude.updated" | "config.claude.removed" | "member.invited" | "member.role_changed" | "member.removed";
+        ActivityLogActorDto: {
+            /** Format: uuid */
+            userId: string;
+            /** Format: email */
+            email?: string | null;
+            name?: string | null;
+        };
+        ActivityLogEntryDto: {
+            /** Format: uuid */
+            id: string;
+            eventType: components["schemas"]["ActivityLogEventTypeDto"];
+            /** @description Namespace prefix derived from event_type (e.g. "fix", "repo", "config"). */
+            eventCategory: string;
+            /** Format: date-time */
+            occurredAt: string;
+            /**
+             * @description Whether the event was triggered by a human user, a batch/system process, or a webhook.
+             * @enum {string}
+             */
+            actorType: "user" | "system" | "webhook";
+            actor?: components["schemas"]["ActivityLogActorDto"] | null;
+            /** Format: uuid */
+            repoId?: string | null;
+            repoName?: string | null;
+            /** Format: uuid */
+            integrationId?: string | null;
+            integrationType?: string | null;
+            /**
+             * Format: uuid
+             * @description ID of the related fix request (fix.* events).
+             */
+            fixRequestId?: string | null;
+            /**
+             * Format: uuid
+             * @description ID of the related readiness issue (fix.* events).
+             */
+            issueId?: string | null;
+            /**
+             * Format: uuid
+             * @description ID of the related readiness run (readiness.* events).
+             */
+            readinessRunId?: string | null;
+            /** @description Event-specific supplementary data (before/after state, installation IDs, etc.). */
+            metadata?: {
+                [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"][];
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -3341,6 +3550,17 @@ export type YourAiJourneyReadinessAggregateDto = components['schemas']['YourAiJo
 export type YourAiJourneyAnalyticsDto = components['schemas']['YourAiJourneyAnalyticsDto'];
 export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAiSpendWeekDto'];
 export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
+export type PatchRepoArchiveBodyDto = components['schemas']['PatchRepoArchiveBodyDto'];
+export type PatchRepoArchiveResponseDto = components['schemas']['PatchRepoArchiveResponseDto'];
+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'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
@@ -5537,6 +5757,8 @@ export interface operations {
                 search?: components["parameters"]["ReadinessRepoSearch"];
                 /** @description Exact language filter (e.g. `typescript`). */
                 language?: components["parameters"]["ReadinessRepoLanguage"];
+                /** @description When `true`, includes Inactive (user-removed) repos alongside Active ones. Default is `false` (active only). */
+                includeArchived?: boolean;
             };
             header?: never;
             path: {
@@ -5751,6 +5973,62 @@ export interface operations {
             };
         };
     };
+    patchReadinessRepo: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                repoId: components["parameters"]["RepoId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PatchRepoArchiveBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Repo status updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PatchRepoArchiveResponseDto"];
+                };
+            };
+            /** @description Malformed request body or 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 */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Conflict — scan in progress or repo already in the requested state */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     listReadinessRepoRuns: {
         parameters: {
             query?: {
@@ -5854,6 +6132,67 @@ export interface operations {
             };
         };
     };
+    listWorkspaceActivity: {
+        parameters: {
+            query?: {
+                /** @description Page size (default 25, max 100). */
+                limit?: components["parameters"]["PaginationLimit"];
+                /** @description Zero-based row offset into the filtered, sorted result set. */
+                offset?: components["parameters"]["PaginationOffset"];
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                /** @description Filter to a specific event type. */
+                eventType?: components["schemas"]["ActivityLogEventTypeDto"];
+                /** @description Filter to events performed by a specific user (UUID). */
+                actorUserId?: string;
+                /** @description ISO-8601 lower bound on `occurredAt` (inclusive). */
+                since?: string;
+                /** @description ISO-8601 upper bound on `occurredAt` (inclusive). */
+                until?: string;
+                /** @description Filter by event namespace prefix (e.g. "fix", "repo", "integration", "readiness", "config", "member"). */
+                eventCategory?: string;
+                /** @description Case-insensitive substring filter applied across repo name, integration type, actor email, and actor display name. */
+                search?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated activity log entries */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ActivityLogPageDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessScoreHistory: {
         parameters: {
             query?: {
@@ -7397,4 +7736,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"];
+                };
+            };
+        };
+    };
 }

package/src/index.ts

@@ -1019,3 +1019,58 @@ export interface YourAiJourneyAiSpendDto {
     activeUsers: number;
   }[];
 }
+
+// --- HRIS (Personio, ZenHR, …) ---
+
+/** A single absence/leave record sourced from an HRIS provider. */
+export interface WorkspaceAbsenceDto {
+  /** HRIS provider that sourced this record ('personio', 'zenhr', …). */
+  source: string;
+  employeeEmail: string;
+  absenceType: string;
+  /** ISO date YYYY-MM-DD */
+  startDate: string;
+  /** ISO date YYYY-MM-DD */
+  endDate: string;
+  halfDayStart: boolean;
+  halfDayEnd: boolean;
+  status: "approved" | "pending" | "rejected";
+}
+
+/** Response body for GET /workspaces/:id/absences */
+export interface WorkspaceAbsenceListDto {
+  absences: WorkspaceAbsenceDto[];
+  /** ISO timestamp of the most recent successful sync, or null if never synced. */
+  syncedAt: string | null;
+}
+
+/** Sync status for a single HRIS provider connected to a workspace. */
+export interface HrisSyncStatusDto {
+  /** Provider identifier ('personio', 'zenhr', …). */
+  provider: string;
+  lastSyncAt: string | null;
+  status: "ok" | "error" | "never";
+  lastError?: string;
+}
+
+/** Response body for GET /workspaces/:id/hris/status */
+export interface HrisSyncStatusListDto {
+  statuses: HrisSyncStatusDto[];
+}
+
+/** Response body for POST /workspaces/:id/hris/sync (manual trigger). */
+export interface HrisTriggerSyncResultDto {
+  status: "ok" | "skipped" | "error";
+  /** Stable machine-readable code (e.g. 'no_personio_source', 'hris_sync_failed'). */
+  code?: string;
+  /** Number of employees synced (present when status = 'ok'). */
+  employeeCount?: number;
+  /** Number of absence records synced (present when status = 'ok'). */
+  absenceCount?: number;
+  /** Wall-clock duration of the sync in milliseconds (present when status = 'ok'). */
+  durationMs?: number;
+  /** Machine-readable reason for a skipped sync (e.g. 'no_personio_source'). */
+  reason?: string;
+  /** Error message when status = 'error'. */
+  error?: string;
+}