[Security Solution][AI Assistant] Update ConversationSummary schema and interface (#13657)

oas_docs/output/kibana.serverless.yaml

@@ -61544,14 +61544,6 @@ components:
         - insights
       example: assistant
       type: string
-    Security_AI_Assistant_API_ConversationConfidence:
-      description: The conversation confidence.
-      enum:
-        - low
-        - medium
-        - high
-      example: high
-      type: string
     Security_AI_Assistant_API_ConversationCreateProps:
       type: object
       properties:
@@ -61636,24 +61628,28 @@ components:
         - namespace
         - category
     Security_AI_Assistant_API_ConversationSummary:
+      allOf:
+        - $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationSummaryBase'
+        - type: object
+          properties:
+            timestamp:
+              $ref: '#/components/schemas/Security_AI_Assistant_API_NonEmptyTimestamp'
+              description: The timestamp summary was updated.
+              example: '2025-04-30T16:00:00Z'
+          required:
+            - timestamp
+    Security_AI_Assistant_API_ConversationSummaryBase:
       type: object
       properties:
-        confidence:
-          $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationConfidence'
-          description: How confident you are about this being a correct and useful learning.
-          example: high
-        content:
+        semanticContent:
           description: Summary text of the conversation over time.
           example: This conversation covered how to configure the Security AI Assistant.
           type: string
-        public:
-          description: Define if summary is marked as publicly available.
-          example: true
-          type: boolean
-        timestamp:
-          $ref: '#/components/schemas/Security_AI_Assistant_API_NonEmptyTimestamp'
-          description: The timestamp summary was updated.
-          example: '2025-04-30T16:00:00Z'
+        summarizedMessageIds:
+          description: The list of summarized messages.
+          items:
+            $ref: '#/components/schemas/Security_AI_Assistant_API_NonEmptyString'
+          type: array
     Security_AI_Assistant_API_ConversationUpdateProps:
       type: object
       properties:
@@ -61677,7 +61673,7 @@ components:
         replacements:
           $ref: '#/components/schemas/Security_AI_Assistant_API_Replacements'
         summary:
-          $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationSummary'
+          $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationSummaryBase'
         title:
           description: The conversation title.
           example: Updated Security AI Assistant Setup

oas_docs/output/kibana.yaml

@@ -74093,14 +74093,6 @@ components:
         - insights
       example: assistant
       type: string
-    Security_AI_Assistant_API_ConversationConfidence:
-      description: The conversation confidence.
-      enum:
-        - low
-        - medium
-        - high
-      example: high
-      type: string
     Security_AI_Assistant_API_ConversationCreateProps:
       type: object
       properties:
@@ -74185,24 +74177,28 @@ components:
         - namespace
         - category
     Security_AI_Assistant_API_ConversationSummary:
+      allOf:
+        - $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationSummaryBase'
+        - type: object
+          properties:
+            timestamp:
+              $ref: '#/components/schemas/Security_AI_Assistant_API_NonEmptyTimestamp'
+              description: The timestamp summary was updated.
+              example: '2025-04-30T16:00:00Z'
+          required:
+            - timestamp
+    Security_AI_Assistant_API_ConversationSummaryBase:
       type: object
       properties:
-        confidence:
-          $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationConfidence'
-          description: How confident you are about this being a correct and useful learning.
-          example: high
-        content:
+        semanticContent:
           description: Summary text of the conversation over time.
           example: This conversation covered how to configure the Security AI Assistant.
           type: string
-        public:
-          description: Define if summary is marked as publicly available.
-          example: true
-          type: boolean
-        timestamp:
-          $ref: '#/components/schemas/Security_AI_Assistant_API_NonEmptyTimestamp'
-          description: The timestamp summary was updated.
-          example: '2025-04-30T16:00:00Z'
+        summarizedMessageIds:
+          description: The list of summarized messages.
+          items:
+            $ref: '#/components/schemas/Security_AI_Assistant_API_NonEmptyString'
+          type: array
     Security_AI_Assistant_API_ConversationUpdateProps:
       type: object
       properties:
@@ -74226,7 +74222,7 @@ components:
         replacements:
           $ref: '#/components/schemas/Security_AI_Assistant_API_Replacements'
         summary:
-          $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationSummary'
+          $ref: '#/components/schemas/Security_AI_Assistant_API_ConversationSummaryBase'
         title:
           description: The conversation title.
           example: Updated Security AI Assistant Setup

x-pack/platform/packages/shared/kbn-elastic-assistant-common/docs/openapi/ess/elastic_assistant_api_2023_10_31.bundled.schema.yaml

@@ -1959,14 +1959,6 @@ components:
         - insights
       example: assistant
       type: string
-    ConversationConfidence:
-      description: The conversation confidence.
-      enum:
-        - low
-        - medium
-        - high
-      example: high
-      type: string
     ConversationCreateProps:
       type: object
       properties:
@@ -2051,28 +2043,30 @@ components:
         - namespace
         - category
     ConversationSummary:
+      allOf:
+        - $ref: '#/components/schemas/ConversationSummaryBase'
+        - type: object
+          properties:
+            timestamp:
+              $ref: '#/components/schemas/NonEmptyTimestamp'
+              description: The timestamp summary was updated.
+              example: '2025-04-30T16:00:00Z'
+          required:
+            - timestamp
+    ConversationSummaryBase:
       type: object
       properties:
-        confidence:
-          $ref: '#/components/schemas/ConversationConfidence'
-          description: >-
-            How confident you are about this being a correct and useful
-            learning.
-          example: high
-        content:
+        semanticContent:
           description: Summary text of the conversation over time.
           example: >-
             This conversation covered how to configure the Security AI
             Assistant.
           type: string
-        public:
-          description: Define if summary is marked as publicly available.
-          example: true
-          type: boolean
-        timestamp:
-          $ref: '#/components/schemas/NonEmptyTimestamp'
-          description: The timestamp summary was updated.
-          example: '2025-04-30T16:00:00Z'
+        summarizedMessageIds:
+          description: The list of summarized messages.
+          items:
+            $ref: '#/components/schemas/NonEmptyString'
+          type: array
     ConversationUpdateProps:
       type: object
       properties:
@@ -2096,7 +2090,7 @@ components:
         replacements:
           $ref: '#/components/schemas/Replacements'
         summary:
-          $ref: '#/components/schemas/ConversationSummary'
+          $ref: '#/components/schemas/ConversationSummaryBase'
         title:
           description: The conversation title.
           example: Updated Security AI Assistant Setup

x-pack/platform/packages/shared/kbn-elastic-assistant-common/docs/openapi/serverless/elastic_assistant_api_2023_10_31.bundled.schema.yaml

@@ -1959,14 +1959,6 @@ components:
         - insights
       example: assistant
       type: string
-    ConversationConfidence:
-      description: The conversation confidence.
-      enum:
-        - low
-        - medium
-        - high
-      example: high
-      type: string
     ConversationCreateProps:
       type: object
       properties:
@@ -2051,28 +2043,30 @@ components:
         - namespace
         - category
     ConversationSummary:
+      allOf:
+        - $ref: '#/components/schemas/ConversationSummaryBase'
+        - type: object
+          properties:
+            timestamp:
+              $ref: '#/components/schemas/NonEmptyTimestamp'
+              description: The timestamp summary was updated.
+              example: '2025-04-30T16:00:00Z'
+          required:
+            - timestamp
+    ConversationSummaryBase:
       type: object
       properties:
-        confidence:
-          $ref: '#/components/schemas/ConversationConfidence'
-          description: >-
-            How confident you are about this being a correct and useful
-            learning.
-          example: high
-        content:
+        semanticContent:
           description: Summary text of the conversation over time.
           example: >-
             This conversation covered how to configure the Security AI
             Assistant.
           type: string
-        public:
-          description: Define if summary is marked as publicly available.
-          example: true
-          type: boolean
-        timestamp:
-          $ref: '#/components/schemas/NonEmptyTimestamp'
-          description: The timestamp summary was updated.
-          example: '2025-04-30T16:00:00Z'
+        summarizedMessageIds:
+          description: The list of summarized messages.
+          items:
+            $ref: '#/components/schemas/NonEmptyString'
+          type: array
     ConversationUpdateProps:
       type: object
       properties:
@@ -2096,7 +2090,7 @@ components:
         replacements:
           $ref: '#/components/schemas/Replacements'
         summary:
-          $ref: '#/components/schemas/ConversationSummary'
+          $ref: '#/components/schemas/ConversationSummaryBase'
         title:
           description: The conversation title.
           example: Updated Security AI Assistant Setup

x-pack/platform/packages/shared/kbn-elastic-assistant-common/impl/schemas/conversations/common_attributes.gen.ts

@@ -298,26 +298,28 @@ export const ApiConfig = z.object({
   model: z.string().optional(),
 });
 
-export type ConversationSummary = z.infer<typeof ConversationSummary>;
-export const ConversationSummary = z.object({
+export type ConversationSummaryBase = z.infer<typeof ConversationSummaryBase>;
+export const ConversationSummaryBase = z.object({
   /**
    * Summary text of the conversation over time.
    */
-  content: z.string().optional(),
-  /**
-   * The timestamp summary was updated.
-   */
-  timestamp: NonEmptyTimestamp.optional(),
+  semanticContent: z.string().optional(),
   /**
-   * Define if summary is marked as publicly available.
+   * The list of summarized messages.
    */
-  public: z.boolean().optional(),
-  /**
-   * How confident you are about this being a correct and useful learning.
-   */
-  confidence: ConversationConfidence.optional(),
+  summarizedMessageIds: z.array(NonEmptyString).optional(),
 });
 
+export type ConversationSummary = z.infer<typeof ConversationSummary>;
+export const ConversationSummary = ConversationSummaryBase.merge(
+  z.object({
+    /**
+     * The timestamp summary was updated.
+     */
+    timestamp: NonEmptyTimestamp,
+  })
+);
+
 export type ErrorSchema = z.infer<typeof ErrorSchema>;
 export const ErrorSchema = z
   .object({
@@ -389,7 +391,7 @@ export const ConversationUpdateProps = z.object({
    * LLM API configuration.
    */
   apiConfig: ApiConfig.optional(),
-  summary: ConversationSummary.optional(),
+  summary: ConversationSummaryBase.optional(),
   /**
    * Exclude from last conversation storage.
    */

x-pack/platform/packages/shared/kbn-elastic-assistant-common/impl/schemas/conversations/common_attributes.schema.yaml

@@ -306,25 +306,30 @@ components:
           description: Model
           example: 'gpt-4'
 
-    ConversationSummary:
+    ConversationSummaryBase:
       type: object
       properties:
-        content:
+        semanticContent:
           type: string
           description: Summary text of the conversation over time.
           example: 'This conversation covered how to configure the Security AI Assistant.'
-        timestamp:
-          $ref: '../common_attributes.schema.yaml#/components/schemas/NonEmptyTimestamp'
-          description: The timestamp summary was updated.
-          example: '2025-04-30T16:00:00Z'
-        public:
-          type: boolean
-          description: Define if summary is marked as publicly available.
-          example: true
-        confidence:
-          $ref: '#/components/schemas/ConversationConfidence'
-          description: How confident you are about this being a correct and useful learning.
-          example: 'high'
+        summarizedMessageIds:
+          type: array
+          description: The list of summarized messages.
+          items:
+            $ref: '../common_attributes.schema.yaml#/components/schemas/NonEmptyString'
+
+    ConversationSummary:
+      allOf:
+        - $ref: '#/components/schemas/ConversationSummaryBase'
+        - type: object
+          required:
+            - timestamp
+          properties:
+            timestamp:
+              $ref: '../common_attributes.schema.yaml#/components/schemas/NonEmptyTimestamp'
+              description: The timestamp summary was updated.
+              example: '2025-04-30T16:00:00Z'
 
     ErrorSchema:
       type: object
@@ -426,7 +431,7 @@ components:
           $ref: '#/components/schemas/ApiConfig'
           description: LLM API configuration.
         summary:
-          $ref: '#/components/schemas/ConversationSummary'
+          $ref: '#/components/schemas/ConversationSummaryBase'
         excludeFromLastConversationStorage:
           description: Exclude from last conversation storage.
           type: boolean