@company-semantics/contracts 86.1.0 → 88.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "86.1.0",
+  "version": "88.0.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -94,6 +94,8 @@
     "lint:md": "markdownlint-cli2 '**/*.md' '#node_modules' '#.ralph/worktrees' '#.claude/worktrees'",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
+    "knip": "knip",
+    "depcruise": "depcruise src scripts tests __tests__",
     "lint:json": "node -e \"JSON.parse(require('fs').readFileSync('package.json'))\"",
     "prepare": "husky",
     "guard:export": "npx tsx scripts/ci/export-guard.ts",
@@ -147,22 +149,24 @@
     "@types/node": "^22.20.4",
     "amphtml-validator": "^1.0.38",
     "culori": "^4.0.2",
+    "dependency-cruiser": "18.4.0",
     "eslint": "^10.11.0",
     "husky": "^9.1.7",
-    "lint-staged": "^17.5.1",
-    "markdownlint-cli2": "^0.23.2",
+    "knip": "6.38.0",
+    "lint-staged": "^17.6.0",
+    "markdownlint-cli2": "^0.23.3",
     "openapi-typescript": "^7.13.0",
-    "prettier": "^3.9.8",
-    "tsx": "^4.23.13",
+    "prettier": "^3.9.9",
+    "tsx": "^4.23.15",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.70.0",
-    "vite": "^8.3.0",
-    "vitest": "^5.0.1",
+    "typescript-eslint": "^8.70.1",
+    "vite": "^8.3.1",
+    "vitest": "^5.0.2",
     "yaml": "^2.9.1"
   },
   "pnpm": {
     "overrides": {
-      "brace-expansion@<5.0.9": ">=5.0.9",
+      "brace-expansion@<5.0.11": ">=5.0.11",
       "smol-toml@<1.7.1": ">=1.7.1",
       "minimatch@<10.2.3": ">=10.2.3",
       "nanoid@<3.3.18": ">=3.3.18",
@@ -182,5 +186,5 @@
     "*.md": "markdownlint-cli2",
     "package.json": "node -e \"JSON.parse(require('fs').readFileSync('package.json'))\""
   },
-  "securityRequirementsVersion": "6a8e38111615e4091c04021fcf69c63a1eac978190b51ef5b8ce07d63e3c9ef8"
+  "securityRequirementsVersion": "bfd57aaebc7d47d195f06ba507ed3fb56da0faa9c40aca3c00f2e63dbd3b617b"
 }

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 = '4ec580fdf79a' as const;
-export const SPEC_HASH_FULL = '4ec580fdf79abef6f817c1afee788dc61a640b4f903b3f5181d0c3a7fc934709' as const;
+export const SPEC_HASH = '2be23467fbc1' as const;
+export const SPEC_HASH_FULL = '2be23467fbc1502200e556fec254b5b7419e748cbe86d73bacb358ee2bb4ac45' as const;

package/src/api/generated.ts

@@ -361,7 +361,7 @@ export interface paths {
         /** List the people taking part in a chat */
         get: operations["listChatParticipants"];
         put?: never;
-        /** Bring a workspace member into a chat */
+        /** Share a chat with a workspace member, Read only or Collaborate */
         post: operations["addChatParticipant"];
         delete?: never;
         options?: never;
@@ -383,7 +383,8 @@ export interface paths {
         delete: operations["removeChatParticipant"];
         options?: never;
         head?: never;
-        patch?: never;
+        /** Change whether someone may only read a chat or also take part */
+        patch: operations["updateChatParticipant"];
         trace?: never;
     };
     "/api/chats/{id}/start-fresh": {
@@ -438,59 +439,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/chats/{chatId}/shares": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** List all active shares for a chat */
-        get: operations["listShares"];
-        put?: never;
-        /** Create a share for a chat */
-        post: operations["createShare"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/shares/{shareId}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
-        /** Revoke a share */
-        delete: operations["revokeShare"];
-        options?: never;
-        head?: never;
-        /** Update a share's visibility or refresh snapshot */
-        patch: operations["updateShare"];
-        trace?: never;
-    };
-    "/api/shared/{token}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** View a shared chat by token */
-        get: operations["getSharedView"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/me/events": {
         parameters: {
             query?: never;
@@ -4925,7 +4873,7 @@ export interface components {
                 proactiveKind?: string | null;
                 participantCount: number;
                 /** @enum {string} */
-                myRole: "owner" | "participant";
+                myRole: "owner" | "participant" | "viewer";
             }[];
             unreadCount?: number;
             nextCursor: string | null;
@@ -4949,7 +4897,7 @@ export interface components {
                 proactiveKind?: string | null;
                 participantCount: number;
                 /** @enum {string} */
-                myRole: "owner" | "participant";
+                myRole: "owner" | "participant" | "viewer";
             };
         };
         CreateChatRequest: {
@@ -5026,11 +4974,13 @@ export interface components {
                 participants?: {
                     userId: string;
                     /** @enum {string} */
-                    role: "owner" | "participant";
+                    role: "owner" | "participant" | "viewer";
                     displayName: string;
                     /** Format: date-time */
                     addedAt: string;
                 }[];
+                /** @enum {string} */
+                myRole: "owner" | "participant" | "viewer";
                 continuity: {
                     subjectId: string;
                     /** @enum {string} */
@@ -5104,16 +5054,23 @@ export interface components {
             participants: {
                 userId: string;
                 /** @enum {string} */
-                role: "owner" | "participant";
+                role: "owner" | "participant" | "viewer";
                 displayName: string;
                 /** Format: date-time */
                 addedAt: string;
             }[];
         };
-        /** @description The workspace member to bring into the chat. */
+        /** @description The workspace member to share the chat with, and whether they may only read it (viewer) or also take part (participant). */
         AddChatParticipantRequest: {
             /** Format: uuid */
             userId: string;
+            /** @enum {string} */
+            role: "participant" | "viewer";
+        };
+        /** @description The access to give this participant: viewer (Read only) or participant (Collaborate). */
+        UpdateChatParticipantRequest: {
+            /** @enum {string} */
+            role: "participant" | "viewer";
         };
         StartFreshChatResponse: {
             chatId: string;
@@ -5133,84 +5090,6 @@ export interface components {
             title: string;
             isAutoGenerated: boolean;
         };
-        CreateShareResponse: {
-            share: {
-                id: string;
-                chatId: string;
-                token?: string;
-                /** @enum {string} */
-                visibility: "private" | "public";
-                shareUrl?: string;
-                messageCountAtShare: number;
-                titleAtShare: string;
-                /** Format: date-time */
-                createdAt: string;
-                createdByName: string;
-                isRevoked: boolean;
-            };
-            shareUrl: string;
-        };
-        CreateShareRequest: {
-            /** @enum {string} */
-            visibility: "public" | "private";
-            /** Format: email */
-            recipientEmail?: string;
-        };
-        ListSharesResponse: {
-            shares: {
-                id: string;
-                chatId: string;
-                token?: string;
-                /** @enum {string} */
-                visibility: "private" | "public";
-                shareUrl?: string;
-                messageCountAtShare: number;
-                titleAtShare: string;
-                /** Format: date-time */
-                createdAt: string;
-                createdByName: string;
-                isRevoked: boolean;
-            }[];
-        };
-        UpdateShareResponse: {
-            share: {
-                id: string;
-                chatId: string;
-                token?: string;
-                /** @enum {string} */
-                visibility: "private" | "public";
-                shareUrl?: string;
-                messageCountAtShare: number;
-                titleAtShare: string;
-                /** Format: date-time */
-                createdAt: string;
-                createdByName: string;
-                isRevoked: boolean;
-            };
-        };
-        UpdateShareRequest: {
-            /** @enum {string} */
-            visibility?: "public" | "private";
-            updateSnapshot?: boolean;
-        };
-        ChatSuccessResponse: {
-            /** @constant */
-            success: true;
-        };
-        SharedChatView: {
-            title: string;
-            messages: {
-                /** @enum {string} */
-                role: "user" | "assistant";
-                content: string;
-                parts?: unknown[];
-            }[];
-            /** Format: date-time */
-            sharedAt: string;
-            sharedByName: string;
-            /** @enum {string} */
-            visibility: "private" | "public";
-        };
         ChatSseEvent: {
             /** @constant */
             v: 1;
@@ -5238,7 +5117,7 @@ export interface components {
                 proactiveKind?: string | null;
                 participantCount: number;
                 /** @enum {string} */
-                myRole: "owner" | "participant";
+                myRole: "owner" | "participant" | "viewer";
             };
         } | {
             /** @constant */
@@ -5266,7 +5145,7 @@ export interface components {
                 proactiveKind?: string | null;
                 participantCount: number;
                 /** @enum {string} */
-                myRole: "owner" | "participant";
+                myRole: "owner" | "participant" | "viewer";
             };
             changed: ("title" | "titleSource" | "pinnedAt")[];
         } | {
@@ -5334,7 +5213,7 @@ export interface components {
             pageContext?: {
                 route: string;
                 /** @enum {string} */
-                view: "chat" | "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
+                view: "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
                 /** @enum {string} */
                 scope: "none" | "me" | "team" | "org";
                 entity?: {
@@ -5380,7 +5259,7 @@ export interface components {
             pageContext?: {
                 route: string;
                 /** @enum {string} */
-                view: "chat" | "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
+                view: "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
                 /** @enum {string} */
                 scope: "none" | "me" | "team" | "org";
                 entity?: {
@@ -5426,7 +5305,7 @@ export interface components {
             pageContext?: {
                 route: string;
                 /** @enum {string} */
-                view: "chat" | "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
+                view: "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
                 /** @enum {string} */
                 scope: "none" | "me" | "team" | "org";
                 entity?: {
@@ -6932,7 +6811,7 @@ export interface components {
                 snippet: string;
                 score: number;
                 /** @enum {string} */
-                matchedVia: "fts" | "vector";
+                matchedVia: "fts" | "fts-any" | "vector";
                 /** @description Where the hit came from, projected per reader after admission; [] when none. */
                 citations: ({
                     /** @constant */
@@ -8516,7 +8395,7 @@ export interface components {
             surface: {
                 route: string;
                 /** @enum {string} */
-                view: "chat" | "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
+                view: "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
                 /** @enum {string} */
                 scope: "none" | "me" | "team" | "org";
                 entity?: {
@@ -8563,7 +8442,7 @@ export interface components {
                 route?: {
                     route: string;
                     /** @enum {string} */
-                    view: "chat" | "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
+                    view: "company-md" | "execution-detail" | "internal-admin" | "notifications" | "org-settings" | "org-work" | "settings" | "team-md" | "teams" | "teamwork" | "teamwork-member" | "timeline" | "upgrade" | "user-md" | "work";
                     /** @enum {string} */
                     scope: "none" | "me" | "team" | "org";
                     entity?: {
@@ -10647,60 +10526,34 @@ export interface operations {
             };
         };
     };
-    startFreshChat: {
+    updateChatParticipant: {
         parameters: {
             query?: never;
             header?: never;
             path: {
                 id: string;
+                userId: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
-        responses: {
-            /** @description The new active chat of the subject */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["StartFreshChatResponse"];
-                };
-            };
-            /** @description The chat is not its subject’s active chat */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["LaunchTargetSuperseded"];
-                };
-            };
-        };
-    };
-    generateChatTitle: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateChatParticipantRequest"];
             };
-            cookie?: never;
         };
-        requestBody?: never;
         responses: {
-            /** @description Title generation result */
+            /** @description The chat’s participants after the change */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GenerateTitleResponse"];
+                    "application/json": components["schemas"]["ChatParticipantsResponse"];
                 };
             };
         };
     };
-    pinChat: {
+    startFreshChat: {
         parameters: {
             query?: never;
             header?: never;
@@ -10711,153 +10564,88 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Chat pinned successfully */
+            /** @description The new active chat of the subject */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SuccessResponse"];
+                    "application/json": components["schemas"]["StartFreshChatResponse"];
                 };
             };
-        };
-    };
-    unpinChat: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Chat unpinned successfully */
-            200: {
+            /** @description The chat is not its subject’s active chat */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SuccessResponse"];
+                    "application/json": components["schemas"]["LaunchTargetSuperseded"];
                 };
             };
         };
     };
-    listShares: {
+    generateChatTitle: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                chatId: string;
+                id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description List of chat shares */
+            /** @description Title generation result */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListSharesResponse"];
-                };
-            };
-        };
-    };
-    createShare: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                chatId: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["CreateShareRequest"];
-            };
-        };
-        responses: {
-            /** @description Share created successfully */
-            201: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CreateShareResponse"];
+                    "application/json": components["schemas"]["GenerateTitleResponse"];
                 };
             };
         };
     };
-    revokeShare: {
+    pinChat: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                shareId: string;
+                id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Share revoked successfully */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ChatSuccessResponse"];
-                };
-            };
-        };
-    };
-    updateShare: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                shareId: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["UpdateShareRequest"];
-            };
-        };
-        responses: {
-            /** @description Share updated successfully */
+            /** @description Chat pinned successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["UpdateShareResponse"];
+                    "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
         };
     };
-    getSharedView: {
+    unpinChat: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                token: string;
+                id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Shared chat view */
+            /** @description Chat unpinned successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SharedChatView"];
+                    "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
         };