@company-semantics/contracts 0.108.0 → 0.109.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.108.0",
+  "version": "0.109.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -82,6 +82,7 @@
     "release": "npx tsx scripts/release.ts",
     "prepublishOnly": "echo 'ERROR: Publishing is CI-only via tag push. Use pnpm release instead.' && exit 1",
     "test": "vitest run",
+    "generate:api": "pnpm generate:api-types",
     "generate:api-types": "openapi-typescript openapi/backend.yaml -o src/api/generated.ts",
     "generate:openapi-routes": "tsx scripts/generate-openapi-routes.ts",
     "generate:api-types:check": "openapi-typescript openapi/backend.yaml -o /tmp/cs-api-types-check.ts && diff -q src/api/generated.ts /tmp/cs-api-types-check.ts"

package/src/api/generated.ts

@@ -503,6 +503,70 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/executions/{executionId}/undo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Undo a completed execution
+         * @description Undoes a completed execution within its undo window.
+         *     The caller must be the same user who initiated the execution.
+         *     Idempotent: if undo was already performed, returns the existing result.
+         */
+        post: operations["undoExecution"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/executions/{executionId}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Confirm a pending execution
+         * @description Confirms a pending execution. Serialized via advisory lock.
+         *     The caller must be the same user who initiated the execution.
+         */
+        post: operations["confirmExecution"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/executions/{executionId}/reject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reject a pending execution
+         * @description Rejects a pending execution. Serialized via advisory lock.
+         *     The caller must be the same user who initiated the execution.
+         */
+        post: operations["rejectExecution"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/timeline": {
         parameters: {
             query?: never;
@@ -2411,6 +2475,46 @@ export interface components {
                 message: string;
             }[];
         };
+        ExecutionLifecycleError: {
+            /** @enum {string} */
+            code: "EXECUTION_CONFLICT";
+            executionId: string;
+            currentState: string;
+        } | {
+            /** @enum {string} */
+            code: "EXECUTION_EXPIRED";
+            executionId: string;
+            /** Format: date-time */
+            expiredAt: string;
+        } | {
+            /** @enum {string} */
+            code: "EXECUTION_FORBIDDEN";
+            executionId: string;
+            requiredRole: string;
+        };
+        UndoResultData: {
+            /** @description Links back to original action */
+            actionId: string;
+            /** @description Original execution row ID */
+            executionId: string;
+            /** @description New undo audit row ID (append-only) */
+            undoExecutionId: string;
+            /** @enum {string} */
+            status: "success" | "failed";
+            error?: string;
+        };
+        ConfirmExecutionResponse: {
+            /** @enum {string} */
+            status: "executing" | "blocked_pending_approval" | "already_confirmed" | "awaiting_approval";
+            code?: string;
+            executionId?: string;
+            /** @description ExecutionResultData when execution completes inline */
+            result?: Record<string, never>;
+        };
+        RejectExecutionResponse: {
+            /** @enum {string} */
+            status: "cancelled";
+        };
         ExecutionSummary: {
             /** Format: uuid */
             executionId: string;
@@ -3904,6 +4008,192 @@ export interface operations {
             };
         };
     };
+    undoExecution: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Execution ID (UUID v4) */
+                executionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Undo result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UndoResultData"];
+                };
+            };
+            /** @description Invalid execution ID format or execution not in undoable state */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Insufficient permissions (not the initiating user) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+            /** @description Execution not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Execution in wrong state (e.g. undo window expired) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+        };
+    };
+    confirmExecution: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Execution ID (UUID v4) */
+                executionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Confirmation result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConfirmExecutionResponse"];
+                };
+            };
+            /** @description Invalid execution ID format */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Insufficient permissions (not the initiating user) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+            /** @description Execution not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Execution not in pending_confirmation state */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+            /** @description Confirmation has expired */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+        };
+    };
+    rejectExecution: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Execution ID (UUID v4) */
+                executionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Rejection result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RejectExecutionResponse"];
+                };
+            };
+            /** @description Invalid execution ID format */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Insufficient permissions (not the initiating user) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+            /** @description Execution not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Execution not in pending_confirmation state */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionLifecycleError"];
+                };
+            };
+        };
+    };
     getTimelineUI: {
         parameters: {
             query?: {
@@ -5908,7 +6198,12 @@ export interface operations {
     };
     listChats: {
         parameters: {
-            query?: never;
+            query?: {
+                search?: string;
+                limit?: number;
+                offset?: number;
+                includePinned?: boolean;
+            };
             header?: never;
             path?: never;
             cookie?: never;

package/src/generated/openapi-routes.ts

@@ -23,9 +23,12 @@ export const openApiRoutes = {
   '/api/drive/files/recent': ['GET'],
   '/api/drive/files/{fileId}/content': ['GET'],
   '/api/executions': ['GET', 'POST'],
+  '/api/executions/{executionId}/confirm': ['POST'],
   '/api/executions/{executionId}/explanation': ['GET'],
+  '/api/executions/{executionId}/reject': ['POST'],
   '/api/executions/{executionId}/summary': ['GET'],
   '/api/executions/{executionId}/timeline': ['GET'],
+  '/api/executions/{executionId}/undo': ['POST'],
   '/api/goals/docs/{slug}': ['GET'],
   '/api/goals/docs/{slug}/content': ['PUT'],
   '/api/goals/docs/{slug}/sharing': ['GET'],