@company-semantics/contracts 49.0.0 → 50.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "49.0.0",
+  "version": "50.0.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = '6aca68a12d82' as const;
-export const SPEC_HASH_FULL = '6aca68a12d828a1efb9e1d1865a3955e8540d9c83563d2d6be6b04ae3eac7da1' as const;
+export const SPEC_HASH = '7ed2b7218b4b' as const;
+export const SPEC_HASH_FULL = '7ed2b7218b4b4a160ba6e9d8854f2e9277d540c33658448d9a0452e96f1cd581' as const;

package/src/api/generated.ts

@@ -3565,6 +3565,74 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/comments/threads/{threadId}/accept-intent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Claim the acceptance lease on an open suggestion */
+        post: operations["acceptSuggestionIntent"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/threads/{threadId}/accept-complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Record the accept decision by claim token */
+        post: operations["acceptSuggestionComplete"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/threads/{threadId}/accept-release": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Release a held acceptance lease without deciding */
+        post: operations["releaseSuggestionClaim"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/threads/{threadId}/reject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Reject an open suggestion (or withdraw as its author) */
+        post: operations["rejectSuggestion"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -6397,7 +6465,16 @@ export interface components {
             /** Format: uuid */
             subjectId: string;
             anchor: components["schemas"]["CommentAnchor"];
-            body: string;
+            /** @enum {string} */
+            kind?: "comment" | "suggestion";
+            suggestion?: {
+                /** @constant */
+                v: 1;
+                /** @enum {string} */
+                op: "insert" | "delete" | "replace";
+                insertedText?: string;
+            };
+            body?: string;
             mentions?: {
                 /** Format: uuid */
                 userId: string;
@@ -6436,6 +6513,14 @@ export interface components {
         CommentThreadSummaryResponse: {
             thread: components["schemas"]["CommentThreadSummary"];
         };
+        /** @description The acceptance lease: the opaque claim token that alone can complete the accept, and how long the lease lives. */
+        SuggestionClaimResponse: {
+            claimToken: string;
+            leaseDurationMs: number;
+        };
+        SuggestionClaimRequest: {
+            claimToken: string;
+        };
         /** @description Server-enforced collaboration size limits, published so clients can pre-check. */
         CollabSyncLimits: {
             maxUpdateBytes: number;
@@ -6473,10 +6558,13 @@ export interface components {
             subjectType: "company_md" | "strategy_doc" | "work_item" | "meeting_recording";
             subjectId: string;
             /** @enum {string} */
-            anchorType: "document" | "text";
+            anchorType: "document" | "text" | "text-insertion";
             anchor: components["schemas"]["CommentAnchor"];
             /** @enum {string} */
             status: "open" | "resolved";
+            /** @enum {string} */
+            kind: "comment" | "suggestion";
+            suggestion: components["schemas"]["Suggestion"] | null;
             createdByUserId: string | null;
             resolvedByUserId: string | null;
             resolvedAt: string | null;
@@ -6484,7 +6572,7 @@ export interface components {
             updatedAt: string;
             comments: components["schemas"]["Comment"][];
         };
-        /** @description Opaque, versioned comment anchor: document-level, or a text anchor with a required quote and optional relative positions. */
+        /** @description Opaque, versioned comment anchor: document-level, a text anchor with a required quote and optional relative positions, or a zero-width text-insertion point for insert suggestions. */
         CommentAnchor: {
             /** @constant */
             type: "document";
@@ -6500,6 +6588,24 @@ export interface components {
             quote: string;
             prefix: string;
             suffix: string;
+        } | {
+            /** @constant */
+            type: "text-insertion";
+            /** @constant */
+            v: 1;
+            relPos?: string;
+            leftContext: string;
+            rightContext: string;
+        };
+        /** @description A suggested edit as proposed: the operation, its insertedText (insert/replace only), and the decision status composed from the thread row. */
+        Suggestion: {
+            /** @constant */
+            v: 1;
+            /** @enum {string} */
+            op: "insert" | "delete" | "replace";
+            insertedText?: string;
+            /** @enum {string} */
+            status: "open" | "accepted" | "rejected";
         };
         /** @description One comment; body is null iff soft-deleted (redacted projection with empty mentions). */
         Comment: {
@@ -6526,10 +6632,13 @@ export interface components {
             subjectType: "company_md" | "strategy_doc" | "work_item" | "meeting_recording";
             subjectId: string;
             /** @enum {string} */
-            anchorType: "document" | "text";
+            anchorType: "document" | "text" | "text-insertion";
             anchor: components["schemas"]["CommentAnchor"];
             /** @enum {string} */
             status: "open" | "resolved";
+            /** @enum {string} */
+            kind: "comment" | "suggestion";
+            suggestion: components["schemas"]["Suggestion"] | null;
             createdByUserId: string | null;
             resolvedByUserId: string | null;
             resolvedAt: string | null;
@@ -12635,6 +12744,13 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Not a comment thread: a suggestion is decided via accept or reject, never resolved */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     reopenCommentThread: {
@@ -12664,6 +12780,179 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Not a comment thread: a decided suggestion is terminal and never reopens */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    acceptSuggestionIntent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Lease claimed: the opaque claim token (the only artifact that can complete the accept) and its duration */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuggestionClaimResponse"];
+                };
+            };
+            /** @description Thread not found, or the caller may not decide suggestions on it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not a suggestion thread, already claimed by a live lease, or already decided */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    acceptSuggestionComplete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SuggestionClaimRequest"];
+            };
+        };
+        responses: {
+            /** @description Suggestion accepted (thread resolved); valid after lease expiry and retry-safe for the same actor */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadSummaryResponse"];
+                };
+            };
+            /** @description Malformed claim token */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Thread not found, or the caller may not read its subject */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not a suggestion thread, or the token does not match a live claim on an open suggestion */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    releaseSuggestionClaim: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SuggestionClaimRequest"];
+            };
+        };
+        responses: {
+            /** @description Lease released; the suggestion stays open and claimable */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadSummaryResponse"];
+                };
+            };
+            /** @description Malformed claim token */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Thread not found, or the caller may not read its subject */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not a suggestion thread, or the token does not match a live claim on an open suggestion */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    rejectSuggestion: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Suggestion rejected (thread resolved) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadSummaryResponse"];
+                };
+            };
+            /** @description Thread not found, or the caller may not decide suggestions on it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not a suggestion thread, a live acceptance lease is held, or already decided */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
 }

package/src/generated/openapi-routes.ts

@@ -23,7 +23,11 @@ export const openApiRoutes = {
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
   '/api/comments': ['GET'],
   '/api/comments/threads': ['POST'],
+  '/api/comments/threads/{threadId}/accept-complete': ['POST'],
+  '/api/comments/threads/{threadId}/accept-intent': ['POST'],
+  '/api/comments/threads/{threadId}/accept-release': ['POST'],
   '/api/comments/threads/{threadId}/comments': ['POST'],
+  '/api/comments/threads/{threadId}/reject': ['POST'],
   '/api/comments/threads/{threadId}/reopen': ['POST'],
   '/api/comments/threads/{threadId}/resolve': ['POST'],
   '/api/comments/{commentId}': ['DELETE', 'PATCH'],