fix: regenerate with correct version

regenerate with sdk-2021-09-03

Author: Hsaylor

assistant/v1.ts

@@ -3426,8 +3426,8 @@ class AssistantV1 extends BaseService {
    * @param {Object} params - The parameters to send to the service.
    * @param {string} params.filter - A cacheable parameter that limits the results to those matching the specified
    * filter. You must specify a filter query that includes a value for `language`, as well as a value for
-   * `request.context.system.assistant_id`, `workspace_id`, or `request.context.metadata.deployment`. For more
-   * information, see the
+   * `request.context.system.assistant_id`, `workspace_id`, or `request.context.metadata.deployment`. These required
+   * filters must be specified using the exact match (`::`) operator. For more information, see the
    * [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).
    * @param {string} [params.sort] - How to sort the returned log events. You can sort by **request_timestamp**. To
    * reverse the sort order, prefix the parameter value with a minus sign (`-`).
@@ -4732,7 +4732,8 @@ namespace AssistantV1 {
   export interface ListAllLogsParams {
     /** A cacheable parameter that limits the results to those matching the specified filter. You must specify a
      *  filter query that includes a value for `language`, as well as a value for `request.context.system.assistant_id`,
-     *  `workspace_id`, or `request.context.metadata.deployment`. For more information, see the
+     *  `workspace_id`, or `request.context.metadata.deployment`. These required filters must be specified using the
+     *  exact match (`::`) operator. For more information, see the
      *  [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).
      */
     filter: string;
@@ -5775,8 +5776,8 @@ namespace AssistantV1 {
     none_of_the_above_prompt?: string;
     /** Whether the disambiguation feature is enabled for the workspace. */
     enabled?: boolean;
-    /** The sensitivity of the disambiguation feature to intent detection conflicts. Set to **high** if you want the
-     *  disambiguation feature to be triggered more often. This can be useful for testing or demonstration purposes.
+    /** The sensitivity of the disambiguation feature to intent detection uncertainty. Higher sensitivity means that
+     *  the disambiguation feature is triggered more often and includes more choices.
      */
     sensitivity?: string;
     /** Whether the order in which disambiguation suggestions are presented should be randomized (but still
@@ -5857,6 +5858,8 @@ namespace AssistantV1 {
     description?: string;
     /** An array of objects specifying channels for which the response is intended. */
     channels?: ResponseGenericChannel[];
+    /** Descriptive text that can be used for screen readers or other situations where the image cannot be seen. */
+    alt_text?: string;
   }
 
   /** DialogNodeOutputGenericDialogNodeOutputResponseTypeOption. */
@@ -6014,6 +6017,8 @@ namespace AssistantV1 {
      *  response is intended for a built-in integration and should not be handled by an API client.
      */
     channels?: ResponseGenericChannel[];
+    /** Descriptive text that can be used for screen readers or other situations where the image cannot be seen. */
+    alt_text?: string;
   }
 
   /** RuntimeResponseGenericRuntimeResponseTypeOption. */

assistant/v2.ts

@@ -1026,12 +1026,27 @@ namespace AssistantV2 {
      *  This can be useful for simulating past or future times for testing purposes, or when analyzing documents such as
      *  news articles.
      *
-     *  This value must be a UTC time value formatted according to ISO 8601 (for example, `2019-06-26T12:00:00Z` for
-     *  noon on 26 June 2019.
+     *  This value must be a UTC time value formatted according to ISO 8601 (for example, `2021-06-26T12:00:00Z` for
+     *  noon UTC on 26 June 2021).
      *
      *  This property is included only if the new system entities are enabled for the skill.
      */
     reference_time?: string;
+    /** The time at which the session started. With the stateful `message` method, the start time is always present,
+     *  and is set by the service based on the time the session was created. With the stateless `message` method, the
+     *  start time is set by the service in the response to the first message, and should be returned as part of the
+     *  context with each subsequent message in the session.
+     *
+     *  This value is a UTC time value formatted according to ISO 8601 (for example, `2021-06-26T12:00:00Z` for noon UTC
+     *  on 26 June 2021).
+     */
+    session_start_time?: string;
+    /** An encoded string that represents the configuration state of the assistant at the beginning of the
+     *  conversation. If you are using the stateless `message` method, save this value and then send it in the context
+     *  of the subsequent message request to avoid disruptions if there are configuration changes during the
+     *  conversation (such as a change to a skill the assistant uses).
+     */
+    state?: string;
   }
 
   /** Contains information specific to a particular skill used by the Assistant. The property name must be the same as the name of the skill (for example, `main skill`). */
@@ -1620,6 +1635,8 @@ namespace AssistantV2 {
      *  response is intended for a built-in integration and should not be handled by an API client.
      */
     channels?: ResponseGenericChannel[];
+    /** Descriptive text that can be used for screen readers or other situations where the image cannot be seen. */
+    alt_text?: string;
   }
 
   /** RuntimeResponseGenericRuntimeResponseTypeOption. */

compare-comply/v1.ts

@@ -68,7 +68,7 @@ class CompareComplyV1 extends BaseService {
   constructor(options: UserOptions) {
     console.warn(`On 30 November 2021, Compare and Comply will no longer be available. 
     For more information, see https://github.com/watson-developer-cloud/node-sdk#compare-and-comply-deprecation`);
-
+    
     options = options || {};
 
     const requiredParams = ['version'];

discovery/v2.ts

@@ -877,8 +877,8 @@ class DiscoveryV2 extends BaseService {
    *   * The user must provide document content, metadata, or both. If the request is missing both document content and
    * metadata, it is rejected.
    *
-   *   * The user can set the **Content-Type** parameter on the **file** part to indicate the media type of the
-   * document. If the **Content-Type** parameter is missing or is one of the generic media types (for example,
+   *   * You can set the **Content-Type** parameter on the **file** part to indicate the media type of the document. If
+   * the **Content-Type** parameter is missing or is one of the generic media types (for example,
    * `application/octet-stream`), then the service attempts to automatically detect the document's media type.
    *
    *   * The following field names are reserved and are filtered out if present after normalization: `id`, `score`,
@@ -891,11 +891,12 @@ class DiscoveryV2 extends BaseService {
    *   If the document is uploaded to a collection that shares its data with another collection, the
    * **X-Watson-Discovery-Force** header must be set to `true`.
    *
-   * **Note:** Documents can be added with a specific **document_id** by using the
-   * **_/v2/projects/{project_id}/collections/{collection_id}/documents** method.
+   * **Note:** You can assign an ID to a document that you add by appending the ID to the endpoint
+   * (`/v2/projects/{project_id}/collections/{collection_id}/documents/{document_id}`). If a document already exists
+   * with the specified ID, it is replaced.
    *
-   * **Note:** This operation only works on collections created to accept direct file uploads. It cannot be used to
-   * modify a collection that connects to an external source such as Microsoft SharePoint.
+   * **Note:** This operation works with a file upload collection. It cannot be used to modify a collection that crawls
+   * an external data source.
    *
    * @param {Object} params - The parameters to send to the service.
    * @param {string} params.projectId - The ID of the project. This information can be found from the *Integrate and
@@ -1538,11 +1539,11 @@ class DiscoveryV2 extends BaseService {
   /**
    * Analyze a Document.
    *
-   * Process a document using the specified collection's settings and return it for realtime use.
+   * Process a document and return it for realtime use. Supports JSON files only.
    *
-   * **Note:** Documents processed using this method are not added to the specified collection.
+   * The document is processed according to the collection's configuration settings but is not stored in the collection.
    *
-   * **Note:** This method is only supported on IBM Cloud Pak for Data instances of Discovery.
+   * **Note:** This method is supported on installed instances of Discovery only.
    *
    * @param {Object} params - The parameters to send to the service.
    * @param {string} params.projectId - The ID of the project. This information can be found from the *Integrate and
@@ -1629,7 +1630,8 @@ class DiscoveryV2 extends BaseService {
   /**
    * List Enrichments.
    *
-   * List the enrichments available to this project.
+   * Lists the enrichments available to this project. The *Part of Speech* and *Sentiment of Phrases* enrichments might
+   * be listed, but are reserved for internal use only.
    *
    * @param {Object} params - The parameters to send to the service.
    * @param {string} params.projectId - The ID of the project. This information can be found from the *Integrate and
@@ -2004,8 +2006,8 @@ class DiscoveryV2 extends BaseService {
    * The `content_intelligence` type is a *Document Retrieval for Contracts* project and the `other` type is a *Custom*
    * project.
    *
-   * The `content_mining` and `content_intelligence` types are available with Premium and Cloud Pak for Data deployments
-   * only.
+   * The `content_mining` and `content_intelligence` types are available with Premium plan managed deployments and
+   * installed deployments only.
    * @param {DefaultQueryParams} [params.defaultQueryParameters] - Default query parameters for this project.
    * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
    * @returns {Promise<DiscoveryV2.Response<DiscoveryV2.ProjectDetails>>}
@@ -2814,8 +2816,8 @@ namespace DiscoveryV2 {
      *  The `content_intelligence` type is a *Document Retrieval for Contracts* project and the `other` type is a
      *  *Custom* project.
      *
-     *  The `content_mining` and `content_intelligence` types are available with Premium and Cloud Pak for Data
-     *  deployments only.
+     *  The `content_mining` and `content_intelligence` types are available with Premium plan managed deployments and
+     *  installed deployments only.
      */
     type: CreateProjectConstants.Type | string;
     /** Default query parameters for this project. */
@@ -2825,7 +2827,7 @@ namespace DiscoveryV2 {
 
   /** Constants for the `createProject` operation. */
   export namespace CreateProjectConstants {
-    /** The type of project. The `content_intelligence` type is a *Document Retrieval for Contracts* project and the `other` type is a *Custom* project. The `content_mining` and `content_intelligence` types are available with Premium and Cloud Pak for Data deployments only. */
+    /** The type of project. The `content_intelligence` type is a *Document Retrieval for Contracts* project and the `other` type is a *Custom* project. The `content_mining` and `content_intelligence` types are available with Premium plan managed deployments and installed deployments only. */
     export enum Type {
       DOCUMENT_RETRIEVAL = 'document_retrieval',
       CONVERSATIONAL_SEARCH = 'conversational_search',
@@ -2913,7 +2915,11 @@ namespace DiscoveryV2 {
   export interface CollectionEnrichment {
     /** The unique identifier of this enrichment. */
     enrichment_id?: string;
-    /** An array of field names that the enrichment is applied to. */
+    /** An array of field names that the enrichment is applied to.
+     *
+     *  If you apply an enrichment to a field from a JSON file, the data is converted to an array automatically, even if
+     *  the field contains a single value.
+     */
     fields?: string[];
   }
 
@@ -3187,8 +3193,8 @@ namespace DiscoveryV2 {
      *  The `content_intelligence` type is a *Document Retrieval for Contracts* project and the `other` type is a
      *  *Custom* project.
      *
-     *  The `content_mining` and `content_intelligence` types are available with Premium and Cloud Pak for Data
-     *  deployments only.
+     *  The `content_mining` and `content_intelligence` types are available with Premium plan managed deployments and
+     *  installed deployments only.
      */
     type?: string;
     /** Relevancy training status information for this project. */
@@ -3210,8 +3216,8 @@ namespace DiscoveryV2 {
      *  The `content_intelligence` type is a *Document Retrieval for Contracts* project and the `other` type is a
      *  *Custom* project.
      *
-     *  The `content_mining` and `content_intelligence` types are available with Premium and Cloud Pak for Data
-     *  deployments only.
+     *  The `content_mining` and `content_intelligence` types are available with Premium plan managed deployments and
+     *  installed deployments only.
      */
     type?: string;
     /** Relevancy training status information for this project. */
@@ -3317,8 +3323,7 @@ namespace DiscoveryV2 {
      *  is set to `false`, then the passage search results are reordered in decreasing order of the highest confidence
      *  answer for each document and passage.
      *
-     *  The **find_answers** parameter is **beta** functionality available only on managed instances and should not be
-     *  used in a production environment. This parameter is not available on installed instances of Discovery.
+     *  The **find_answers** parameter is available only on managed instances of Discovery.
      */
     find_answers?: boolean;
     /** The number of `answer` objects to return per passage if the **find_answers** parmeter is specified as
@@ -3811,7 +3816,7 @@ namespace DiscoveryV2 {
   export interface QueryHistogramAggregation extends QueryAggregation {
     /** The numeric field name used to create the histogram. */
     field: string;
-    /** The size of the sections the results are split into. */
+    /** The size of the sections that the results are split into. */
     interval: number;
     /** Identifier specified in the query request of this aggregation. */
     name?: string;

natural-language-classifier/v1.ts

@@ -30,9 +30,16 @@ import {
 import { getSdkHeaders } from '../lib/common';
 
 /**
- * IBM Watson™ Natural Language Classifier uses machine learning algorithms to return the top matching predefined
- * classes for short text input. You create and train a classifier to connect predefined classes to example texts so
- * that the service can apply those classes to new inputs.
+ * On 9 August 2021, IBM announced the deprecation of IBM Watson™ Natural Language Classifier. As of 9 September
+ * 2021, you cannot create new instances. However, existing instances are supported until 8 August 2022. The service
+ * will no longer be available on 8 August 2022.<br/><br/>As an alternative, consider migrating to IBM Watson Natural
+ * Language Understanding. For more information, see [Migrating to Natural Language
+ * Understanding](https://cloud.ibm.com/docs/natural-language-classifier?topic=natural-language-classifier-migrating).
+ * {: deprecated}
+ *
+ * Natural Language Classifier uses machine learning algorithms to return the top matching predefined classes for short
+ * text input. You create and train a classifier to connect predefined classes to example texts so that the service can
+ * apply those classes to new inputs.
  *
  * API Version: 1.0
  * See: https://cloud.ibm.com/docs/natural-language-classifier

natural-language-understanding/v1.ts

@@ -1038,11 +1038,11 @@ class NaturalLanguageUnderstandingV1 extends BaseService {
    *
    * @param {Object} [params] - The parameters to send to the service.
    * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
-   * @returns {Promise<NaturalLanguageUnderstandingV1.Response<NaturalLanguageUnderstandingV1.ListClassificationsModelsResponse>>}
+   * @returns {Promise<NaturalLanguageUnderstandingV1.Response<NaturalLanguageUnderstandingV1.ClassificationsModelList>>}
    */
   public listClassificationsModels(
     params?: NaturalLanguageUnderstandingV1.ListClassificationsModelsParams
-  ): Promise<NaturalLanguageUnderstandingV1.Response<NaturalLanguageUnderstandingV1.ListClassificationsModelsResponse>> {
+  ): Promise<NaturalLanguageUnderstandingV1.Response<NaturalLanguageUnderstandingV1.ClassificationsModelList>> {
     const _params = { ...params };
 
     const query = {
@@ -2031,11 +2031,6 @@ namespace NaturalLanguageUnderstandingV1 {
     sentiment?: FeatureSentimentResults;
   }
 
-  /** ListClassificationsModelsResponse. */
-  export interface ListClassificationsModelsResponse {
-    models?: ClassificationsModelList[];
-  }
-
   /** Custom models that are available for entities and relations. */
   export interface ListModelsResults {
     /** An array of available models. */