Merge branch 'master' into v4.0.0-branch

Author: dpopp07

.pre-commit-config.yaml

@@ -0,0 +1,5 @@
+- repo: git@github.ibm.com:Whitewater/whitewater-detect-secrets
+  rev: master
+  hooks:
+    -   id: detect-secrets # pragma: whitelist secret
+        args: [--baseline, .secrets.baseline, --no-keyword-scan ]

.secrets.baseline

@@ -0,0 +1,25 @@
+{
+  "exclude_regex": null,
+  "generated_at": "2019-01-17T19:54:14Z",
+  "plugins_used": [
+    {
+      "base64_limit": 4.5,
+      "name": "Base64HighEntropyString"
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "hex_limit": 3,
+      "name": "HexHighEntropyString"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "SlackDetector"
+    }
+  ],
+  "results": {},
+  "version": "0.10.3"
+}

CHANGELOG.md

@@ -1,3 +1,34 @@
+# [3.16.0](https://github.com/watson-developer-cloud/node-sdk/compare/v3.15.4...v3.16.0) (2019-01-17)
+
+
+### Features
+
+* **discovery:** add methods `createStopwordList`, `deleteStopwordList`, `createGateway`, `deleteGateway`, `getGateway`, and `listGateways` ([8a6753e](https://github.com/watson-developer-cloud/node-sdk/commit/8a6753e))
+* **speech-to-text:** new methods added: addGrammar, deleteGrammar, getGrammar, listGrammars ([7ab567a](https://github.com/watson-developer-cloud/node-sdk/commit/7ab567a))
+* **visual-recognition:** parameter `accept_language` added to method `detectFaces` ([82190c7](https://github.com/watson-developer-cloud/node-sdk/commit/82190c7))
+
+## [3.15.4](https://github.com/watson-developer-cloud/node-sdk/compare/v3.15.3...v3.15.4) (2019-01-15)
+
+
+### Bug Fixes
+
+* fix bug that prevents `audio` from being sent as a buffer for `recognize` ([3f97b80](https://github.com/watson-developer-cloud/node-sdk/commit/3f97b80))
+
+## [3.15.3](https://github.com/watson-developer-cloud/node-sdk/compare/v3.15.2...v3.15.3) (2019-01-15)
+
+
+### Bug Fixes
+
+* package.json to reduce vulnerabilities ([e61d1de](https://github.com/watson-developer-cloud/node-sdk/commit/e61d1de))
+
+## [3.15.2](https://github.com/watson-developer-cloud/node-sdk/compare/v3.15.1...v3.15.2) (2019-01-14)
+
+
+### Bug Fixes
+
+* query parameters no longer cause text-to-speech over websockets to crash ([775e6d2](https://github.com/watson-developer-cloud/node-sdk/commit/775e6d2))
+* Remove the `disabled` property from `CreateDialogNode`. It is for internal use only. ([4b72d0e](https://github.com/watson-developer-cloud/node-sdk/commit/4b72d0e))
+
 ## [3.15.1](https://github.com/watson-developer-cloud/node-sdk/compare/v3.15.0...v3.15.1) (2019-01-07)
 
 

assistant/v1.ts

@@ -324,7 +324,7 @@ namespace AssistantV2 {
 
   /** An object defining the message input to be sent to the assistant if the user selects the corresponding option. */
   export interface DialogNodeOutputOptionsElementValue {
-    /** The user input. */
+    /** An input object that includes the input text. */
     input?: MessageInput;
   }
 
@@ -378,7 +378,7 @@ namespace AssistantV2 {
 
   /** An object defining the message input to be sent to the assistant if the user selects the corresponding disambiguation option. */
   export interface DialogSuggestionValue {
-    /** The user input. */
+    /** An input object that includes the input text. */
     input?: MessageInput;
   }
 
@@ -392,33 +392,39 @@ namespace AssistantV2 {
 
   /** Contains information that can be shared by all skills within the Assistant. */
   export interface MessageContextGlobal {
-    /** Properties interpreted by the Assistant that are shared across all skills within the Assistant. */
+    /** Properties that are shared by all skills used by the assistant. */
     system?: MessageContextGlobalSystem;
   }
 
   /** Properties that are shared by all skills used by the assistant. */
   export interface MessageContextGlobalSystem {
     /** The user time zone. The assistant uses the time zone to correctly resolve relative time references. */
     timezone?: string;
-    /** A string value that identifies the user who is interacting with the assistant. The client must provide a unique identifier for each individual end user who accesses the application. This user ID may be used for billing and other purposes. */
+    /** A string value that identifies the user who is interacting with the assistant. The client must provide a unique identifier for each individual end user who accesses the application. For Plus and Premium plans, this user ID is used to identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters. */
     user_id?: string;
     /** A counter that is automatically incremented with each turn of the conversation. A value of 1 indicates that this is the the first turn of a new conversation, which can affect the behavior of some skills. */
     turn_count?: number;
   }
 
+  /** Contains information specific to a particular skill within the Assistant. */
+  export interface MessageContextSkill {
+    /** Arbitrary variables that can be read and written to by a particular skill within the Assistant. */
+    user_defined?: string;
+  }
+
   /** Contains information specific to particular skills within the Assistant. */
   export interface MessageContextSkills {
     /** MessageContextSkills accepts additional properties. */
     [propName: string]: any;
   }
 
-  /** The user input. */
+  /** An input object that includes the input text. */
   export interface MessageInput {
     /** The type of user input. Currently, only text input is supported. */
     message_type?: string;
     /** The text of the user input. This string cannot contain carriage return, newline, or tab characters, and it must be no longer than 2048 characters. */
     text?: string;
-    /** Properties that control how the assistant responds. */
+    /** Optional properties that control how the assistant responds. */
     options?: MessageInputOptions;
     /** Intents to use when evaluating the user input. Include intents from the previous response to continue using those intents rather than trying to recognize intents in the new input. */
     intents?: RuntimeIntent[];
@@ -432,7 +438,7 @@ namespace AssistantV2 {
   export interface MessageInputOptions {
     /** Whether to return additional diagnostic information. Set to `true` to return additional information under the `output.debug` key. */
     debug?: boolean;
-    /** Whether to start a new conversation with this user input. Specify `true` to clear the state information stored by the session. */
+    /** Whether to restart dialog processing at the root of the dialog, regardless of any previously visited nodes. **Note:** This does not affect `turn_count` or any other context variables. */
     restart?: boolean;
     /** Whether to return more than one intent. Set to `true` to return all matching intents. */
     alternate_intents?: boolean;
@@ -472,7 +478,7 @@ namespace AssistantV2 {
   export interface MessageResponse {
     /** Assistant output to be rendered or processed by the client. */
     output: MessageOutput;
-    /** The current session context. Included in the response if the `return_context` property of the message input was set to `true`. */
+    /** State information for the conversation. */
     context?: MessageContext;
   }