@thinkai/tai-api-contract 2.22.0 → 2.23.0

package/dist/generated/openapi.d.ts

@@ -45,6 +45,27 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/admin/readiness/token-usage/by-dimension": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Token usage grouped by operation type and dimension
+         * @description Returns token consumption aggregated across all runs, grouped by `(operation, dimensionId)`. Analysis runs contribute per-dimension rows written by the readiness worker; fix runs contribute their existing per-criterion rows. Results are ordered by `operation` then `dimensionId`.
+         *     **Authorization:** Bearer JWT required. Caller email must appear in `PLATFORM_ADMIN_EMAILS`.
+         */
+        get: operations["adminListReadinessTokenUsageByDimension"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/me": {
         parameters: {
             query?: never;
@@ -3647,6 +3668,60 @@ export interface components {
              */
             createdAt: string;
         };
+        ReadinessTokenUsageByDimensionRowDto: {
+            /**
+             * Format: uuid
+             * @description Workspace that owns the runs.
+             */
+            workspaceId: string;
+            /** @description Repository slug (e.g. `owner/repo`). */
+            providerSlug: string;
+            /**
+             * @description Operation type — analysis or fix.
+             * @enum {string}
+             */
+            operation: "readiness_analysis" | "readiness_fix";
+            /** @description Readiness dimension identifier. */
+            dimensionId: string;
+            /** @description Total primary Cursor Agent invocations across all runs. */
+            totalInvocationCount: number;
+            /** @description Total retry invocations across all runs. */
+            totalRetryInvocationCount: number;
+            /**
+             * Format: int64
+             * @description Sum of input tokens across all runs for this operation+dimension.
+             */
+            totalInputTokens: number;
+            /**
+             * Format: int64
+             * @description Sum of output tokens across all runs.
+             */
+            totalOutputTokens: number;
+            /**
+             * Format: int64
+             * @description Sum of cache-read tokens across all runs.
+             */
+            totalCacheReadTokens: number;
+            /**
+             * Format: int64
+             * @description Sum of cache-write tokens across all runs.
+             */
+            totalCacheWriteTokens: number;
+            /** @description Total rubric criteria processed (analysis runs only; 0 for fix rows). */
+            totalCriteriaCount: number;
+            /** @description Number of distinct runs contributing to this row. */
+            runCount: number;
+            /**
+             * Format: date-time
+             * @description Timestamp of the earliest contributing run (UTC).
+             */
+            firstSeenAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp of the most recent contributing run (UTC).
+             */
+            lastSeenAt: string;
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -3893,6 +3968,7 @@ export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto
 export type HrisTriggerSyncResultDto = components['schemas']['HrisTriggerSyncResultDto'];
 export type ActivityLogPageDto = components['schemas']['ActivityLogPageDto'];
 export type ReadinessTokenUsageRowDto = components['schemas']['ReadinessTokenUsageRowDto'];
+export type ReadinessTokenUsageByDimensionRowDto = components['schemas']['ReadinessTokenUsageByDimensionRowDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
@@ -4052,6 +4128,67 @@ export interface operations {
             };
         };
     };
+    adminListReadinessTokenUsageByDimension: {
+        parameters: {
+            query?: {
+                /** @description Filter by workspace UUID. */
+                workspaceId?: string;
+                /** @description Filter by repository slug (e.g. `owner/repo`). */
+                providerSlug?: string;
+                /** @description Filter by operation type. */
+                operation?: "readiness_analysis" | "readiness_fix";
+                /** @description Filter by a specific readiness dimension ID. */
+                dimensionId?: string;
+                /** @description Include only rows whose last activity is at or after this ISO-8601 timestamp. */
+                from?: string;
+                /** @description Include only rows whose first activity is at or before this ISO-8601 timestamp. */
+                to?: string;
+                /** @description Maximum number of rows to return (default 200, max 500). */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Token usage grouped by operation and dimension. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        rows: components["schemas"]["ReadinessTokenUsageByDimensionRowDto"][];
+                    };
+                };
+            };
+            /** @description Missing or invalid JWT. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Caller is not a platform admin. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "forbidden"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getMe: {
         parameters: {
             query?: never;