feat(assistant-v2): support for search skill added

Author: dpopp07

assistant/v2.ts

@@ -429,6 +429,10 @@ namespace AssistantV2 {
     topic?: string;
     /** An array of objects describing the possible matching dialog nodes from which the user can choose. **Note:** The **suggestions** property is part of the disambiguation feature, which is only available for Premium users. */
     suggestions?: DialogSuggestion[];
+    /** The title or introductory text to show before the response. This text is defined in the search skill configuration. */
+    header?: string;
+    /** An array of objects containing search results. */
+    results?: SearchResult[];
   }
 
   /** DialogSuggestion. */
@@ -547,15 +551,15 @@ namespace AssistantV2 {
     context?: MessageContext;
   }
 
-  /** A term from the request that was identified as an entity. */
+  /** The entity value that was recognized in the user input. */
   export interface RuntimeEntity {
     /** An entity detected in the input. */
     entity: string;
     /** An array of zero-based character offsets that indicate where the detected entity values begin and end in the input text. */
     location: number[];
     /** The term in the input text that was recognized as an entity value. */
     value: string;
-    /** A decimal percentage that represents Watson's confidence in the entity. */
+    /** A decimal percentage that represents Watson's confidence in the recognized entity. */
     confidence?: number;
     /** Any metadata for the entity. */
     metadata?: JsonObject;
@@ -571,6 +575,42 @@ namespace AssistantV2 {
     confidence: number;
   }
 
+  /** SearchResult. */
+  export interface SearchResult {
+    /** The unique identifier of the document in the Discovery service collection. This property is included in responses from search skills, which are a beta feature available only to Plus or Premium plan users. */
+    id: string;
+    /** An object containing search result metadata from the Discovery service. */
+    result_metadata: SearchResultMetadata;
+    /** A description of the search result. This is taken from an abstract, summary, or highlight field in the Discovery service response, as specified in the search skill configuration. */
+    body?: string;
+    /** The title of the search result. This is taken from a title or name field in the Discovery service response, as specified in the search skill configuration. */
+    title?: string;
+    /** The URL of the original data object in its native data source. */
+    url?: string;
+    /** An object containing segments of text from search results with query-matching text highlighted using HTML <em> tags. */
+    highlight?: SearchResultHighlight;
+  }
+
+  /** An object containing segments of text from search results with query-matching text highlighted using HTML <em> tags. */
+  export interface SearchResultHighlight {
+    /** An array of strings containing segments taken from body text in the search results, with query-matching substrings highlighted. */
+    body?: string[];
+    /** An array of strings containing segments taken from title text in the search results, with query-matching substrings highlighted. */
+    title?: string[];
+    /** An array of strings containing segments taken from URLs in the search results, with query-matching substrings highlighted. */
+    url?: string[];
+    /** SearchResultHighlight accepts additional properties. */
+    [propName: string]: any;
+  }
+
+  /** An object containing search result metadata from the Discovery service. */
+  export interface SearchResultMetadata {
+    /** The confidence score for the given result. For more information about how the confidence is calculated, see the Discovery service [documentation](../discovery#query-your-collection). */
+    confidence?: number;
+    /** An unbounded measure of the relevance of a particular result, dependent on the query and matching document. A higher score indicates a greater match to the query parameters. */
+    score?: number;
+  }
+
   /** SessionResponse. */
   export interface SessionResponse {
     /** The session ID. */