@company-semantics/contracts 63.4.0 → 63.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "63.4.0",
+  "version": "63.5.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 = 'c73ab06a4768' as const;
-export const SPEC_HASH_FULL = 'c73ab06a476873a5f782ce5969fd3641f07372d69b4a60feade7305c428f116f' as const;
+export const SPEC_HASH = '0d2acd64eacb' as const;
+export const SPEC_HASH_FULL = '0d2acd64eacb1b9c0e7433170aa68300d2ad9197870f35b3b420f55d9e597abf' as const;

package/src/api/generated.ts

@@ -264,6 +264,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/chats/mentionable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the principals the chat composer may mention */
+        get: operations["listChatMentionable"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/chats/{id}": {
         parameters: {
             query?: never;
@@ -4087,6 +4104,20 @@ export interface components {
         ChatByInteractionResponse: {
             chatId: string;
         };
+        ChatMentionableResponse: {
+            items: {
+                principal: {
+                    /** @constant */
+                    kind: "user";
+                    userId: string;
+                } | {
+                    /** @constant */
+                    kind: "agent";
+                };
+                displayName: string;
+                avatarUrl: string | null;
+            }[];
+        };
         GetChatResponse: {
             chat: {
                 id: string;
@@ -4324,6 +4355,19 @@ export interface components {
                 role: "user";
                 parts: unknown[];
             };
+            mentions?: ({
+                /** @constant */
+                kind: "user";
+                /** Format: uuid */
+                userId: string;
+                startOffset: number;
+                endOffset: number;
+            } | {
+                /** @constant */
+                kind: "agent";
+                startOffset: number;
+                endOffset: number;
+            })[];
             messages?: unknown;
             runtimeProfile?: string;
             pageContext?: {
@@ -5377,6 +5421,7 @@ export interface components {
                     };
                 };
             };
+            chatMentions: boolean;
         };
         OrgStructureReviewQueue: {
             items: {
@@ -7781,6 +7826,28 @@ export interface operations {
             };
         };
     };
+    listChatMentionable: {
+        parameters: {
+            query?: {
+                q?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The mention candidates the composer may offer */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatMentionableResponse"];
+                };
+            };
+        };
+    };
     getChat: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -15,6 +15,7 @@ export const openApiRoutes = {
   '/api/chats': ['GET', 'POST'],
   '/api/chats/by-interaction/{interactionId}': ['GET'],
   '/api/chats/events': ['GET'],
+  '/api/chats/mentionable': ['GET'],
   '/api/chats/proactive/{eventId}': ['GET'],
   '/api/chats/{chatId}/shares': ['GET', 'POST'],
   '/api/chats/{id}': ['DELETE', 'GET', 'PATCH'],

package/src/org/schemas.ts

@@ -2133,6 +2133,11 @@ export const CapabilitiesResponseSchema = z.object({
         .optional(),
     })
     .optional(),
+  // Gates the chat composer's mention affordance (PRD-00988). Optional for the
+  // same rollout symmetry as the action sub-objects above: a backend that does
+  // not yet derive the flag must still validate its own response, and the spec
+  // already carried the field before this schema did.
+  chatMentions: z.boolean().optional(),
 });
 
 export type FieldCapability = z.infer<typeof FieldCapabilitySchema>;