@company-semantics/contracts 45.1.0 → 45.3.0

package/src/api/generated.ts

@@ -1531,6 +1531,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/company-md/docs/{id}/mentionable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the document readers the caller may mention */
+        get: operations["listCompanyMdMentionableUsers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/extract": {
         parameters: {
             query?: never;
@@ -3394,6 +3411,109 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/comments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List a subject's comment threads */
+        get: operations["listCommentThreads"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/threads": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Open a comment thread on a subject */
+        post: operations["createCommentThread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/threads/{threadId}/comments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Reply into a comment thread */
+        post: operations["replyToCommentThread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/{commentId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Soft-delete a comment (author or subject owner) */
+        delete: operations["deleteComment"];
+        options?: never;
+        head?: never;
+        /** Edit a comment's body (author-only) */
+        patch: operations["editComment"];
+        trace?: never;
+    };
+    "/api/comments/threads/{threadId}/resolve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Resolve a comment thread */
+        post: operations["resolveCommentThread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/comments/threads/{threadId}/reopen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Reopen a resolved comment thread */
+        post: operations["reopenCommentThread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -4036,6 +4156,10 @@ export interface components {
             unitMembershipsTruncated: boolean;
             inviteStatus: ("active" | "pending" | "expired") | null;
             effectiveScopes: string[];
+            scopeProvenance?: {
+                scope: string;
+                bands: string[];
+            }[];
             recentActions: {
                 id: string;
                 timestamp: string;
@@ -4784,6 +4908,10 @@ export interface components {
             seq: string;
             update: string;
         };
+        /** @description The document readers the caller may mention, ordered and bounded. */
+        CompanyMdMentionableResponse: {
+            items: components["schemas"]["CompanyMdMentionableCandidate"][];
+        };
         CompanyMdContextBankResponse: {
             items: {
                 id: string;
@@ -5630,7 +5758,7 @@ export interface components {
                 notification: {
                     id: string;
                     /** @enum {string} */
-                    kind: "companyMd.access_requested" | "companyMd.access_request_approved" | "companyMd.access_request_denied";
+                    kind: "companyMd.access_requested" | "companyMd.access_request_approved" | "companyMd.access_request_denied" | "comment.mention" | "comment.reply";
                     target: {
                         /** @enum {string} */
                         type: "company_md" | "org_unit" | "org" | "execution";
@@ -6156,11 +6284,70 @@ export interface components {
                 userAgent: string;
             } | null;
         };
+        /** @description Every thread on the subject the caller may see. */
+        CommentThreadListResponse: {
+            threads: components["schemas"]["CommentThread"][];
+        };
+        /** @description The created thread with its opening comment. */
+        CommentThreadResponse: {
+            thread: components["schemas"]["CommentThread"];
+        };
+        CreateCommentThreadRequest: {
+            /** @enum {string} */
+            subjectType: "company_md" | "strategy_doc" | "work_item" | "meeting_recording";
+            /** Format: uuid */
+            subjectId: string;
+            anchor: components["schemas"]["CommentAnchor"];
+            body: string;
+            mentions?: {
+                /** Format: uuid */
+                userId: string;
+                startOffset: number;
+                endOffset: number;
+            }[];
+        };
+        /** @description The written reply, and whether it auto-reopened a resolved thread. */
+        CommentReplyResponse: {
+            comment: components["schemas"]["Comment"];
+            reopened: boolean;
+        };
+        CommentReplyRequest: {
+            body: string;
+            mentions?: {
+                /** Format: uuid */
+                userId: string;
+                startOffset: number;
+                endOffset: number;
+            }[];
+        };
+        /** @description The comment after the mutation (redacted projection after delete). */
+        CommentResponse: {
+            comment: components["schemas"]["Comment"];
+        };
+        EditCommentRequest: {
+            body: string;
+            mentions?: {
+                /** Format: uuid */
+                userId: string;
+                startOffset: number;
+                endOffset: number;
+            }[];
+        };
+        /** @description The thread after a resolve/reopen transition. */
+        CommentThreadSummaryResponse: {
+            thread: components["schemas"]["CommentThreadSummary"];
+        };
         /** @description Server-enforced collaboration size limits, published so clients can pre-check. */
         CollabSyncLimits: {
             maxUpdateBytes: number;
             maxDocTextBytes: number;
         };
+        /** @description A principal who can read the document and may therefore be mentioned. */
+        CompanyMdMentionableCandidate: {
+            userId: string;
+            displayName: string;
+            avatarUrl: string | null;
+        };
         /** @description An ACL-admitted context-doc discovery hit. */
         ContextDocDiscoveryHit: {
             id: string;
@@ -6174,6 +6361,76 @@ export interface components {
             /** @enum {string} */
             matchedVia: "fts" | "vector";
         };
+        /** @description A comment thread with all its comments oldest-first; soft-deleted comments appear redacted, never filtered out. */
+        CommentThread: {
+            id: string;
+            /** @enum {string} */
+            subjectType: "company_md" | "strategy_doc" | "work_item" | "meeting_recording";
+            subjectId: string;
+            /** @enum {string} */
+            anchorType: "document" | "text";
+            anchor: components["schemas"]["CommentAnchor"];
+            /** @enum {string} */
+            status: "open" | "resolved";
+            createdByUserId: string | null;
+            resolvedByUserId: string | null;
+            resolvedAt: string | null;
+            createdAt: string;
+            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. */
+        CommentAnchor: {
+            /** @constant */
+            type: "document";
+            /** @constant */
+            v: 1;
+        } | {
+            /** @constant */
+            type: "text";
+            /** @constant */
+            v: 1;
+            relStart?: string;
+            relEnd?: string;
+            quote: string;
+            prefix: string;
+            suffix: string;
+        };
+        /** @description One comment; body is null iff soft-deleted (redacted projection with empty mentions). */
+        Comment: {
+            id: string;
+            threadId: string;
+            authorUserId: string | null;
+            body: string | null;
+            editedAt: string | null;
+            deletedAt: string | null;
+            createdAt: string;
+            mentions: components["schemas"]["CommentMention"][];
+        };
+        /** @description One mention on a comment: the mentioned user id, its zero-based exclusive-end UTF-16 range (null until the offset columns exist), and the display name resolved at read time. */
+        CommentMention: {
+            userId: string;
+            startOffset: number | null;
+            endOffset: number | null;
+            displayName: string;
+        };
+        /** @description A comment thread without its comments. */
+        CommentThreadSummary: {
+            id: string;
+            /** @enum {string} */
+            subjectType: "company_md" | "strategy_doc" | "work_item" | "meeting_recording";
+            subjectId: string;
+            /** @enum {string} */
+            anchorType: "document" | "text";
+            anchor: components["schemas"]["CommentAnchor"];
+            /** @enum {string} */
+            status: "open" | "resolved";
+            createdByUserId: string | null;
+            resolvedByUserId: string | null;
+            resolvedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -8569,6 +8826,45 @@ export interface operations {
             };
         };
     };
+    listCompanyMdMentionableUsers: {
+        parameters: {
+            query?: {
+                q?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Document readers the caller may mention, ordered and bounded */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CompanyMdMentionableResponse"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Document not found, or the caller may not comment on it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     extractCompanyMd: {
         parameters: {
             query?: never;
@@ -11905,4 +12201,247 @@ export interface operations {
             };
         };
     };
+    listCommentThreads: {
+        parameters: {
+            query: {
+                subjectType: "company_md" | "strategy_doc" | "work_item" | "meeting_recording";
+                subjectId: string;
+                status?: "open" | "resolved";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Every thread on the subject with its comments oldest-first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadListResponse"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Subject not found, or the caller may not read it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    createCommentThread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCommentThreadRequest"];
+            };
+        };
+        responses: {
+            /** @description Thread created with its opening comment (one transaction) */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadResponse"];
+                };
+            };
+            /** @description Invalid body (including every anchor-corpus reject case) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Subject not found, or the caller may not comment on it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    replyToCommentThread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CommentReplyRequest"];
+            };
+        };
+        responses: {
+            /** @description Reply written; reopened=true when it auto-reopened a resolved thread */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentReplyResponse"];
+                };
+            };
+            /** @description Invalid body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Thread not found, or the caller may not comment on its subject */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    deleteComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                commentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Comment soft-deleted; response carries the redacted projection */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentResponse"];
+                };
+            };
+            /** @description Comment not found, already deleted, or the caller may not delete it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    editComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                commentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EditCommentRequest"];
+            };
+        };
+        responses: {
+            /** @description Comment updated with edited_at stamped */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentResponse"];
+                };
+            };
+            /** @description Invalid body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Comment not found, deleted, or the caller is not its author */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    resolveCommentThread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Thread resolved with resolved_at + resolved_by stamped */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadSummaryResponse"];
+                };
+            };
+            /** @description Thread not found, or the caller may not comment on its subject */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    reopenCommentThread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Thread reopened with the resolution stamp cleared */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadSummaryResponse"];
+                };
+            };
+            /** @description Thread not found, or the caller may not comment on its subject */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
 }