1.1.0 (2018-12-11)

Features

• AssistantV1: Add metadata field to Context model (13a90c1)
• AssistantV1: Add option to sort results in getWorkspace() (5cefc7b)
• DiscoveryV1: Add new concepts property to NluEnrichmentFeatures model (80258db)
• DiscoveryV1: Add retrievalDetails property to QueryResponse model (631affc)
• NaturalLanguageUnderstandingV1: Add 4 new properties to the Model model (53fe057)
• NaturalLanguageUnderstandingV1: Add new count property to KeywordsResult model (ab9a339)
• NaturalLanguageUnderstandingV1: Add new limit property to CategoriesOptions model (5bf6637)

1.0.0 (2018-12-06)

All Services

• failure and success callbacks are replaced with a single completionHandler of type (WatsonResponse<T>?, WatsonError?) -> Void
• New WatsonResponse type in the completion handlers that contains the response HTTP status, headers, and data
• New WatsonError type in the completion handlers that contains more useful and detailed information about the error that occurred
• Change the type of date-time properties from String to Date
• Remove all deprecated types, methods, and properties
• All parameters now get passed directly to methods rather than packaging them up in the properties parameter
• All models are now Codable, instead of only being Encodable or Decodable, so they can be converted both to and from JSON
• All models are now Equatable

ConversationV1

• REMOVED - use AssistantV1 instead

LanguageTranslatorV2

• REMOVED - use LanguageTranslatorV3 instead

NaturalLanguageUnderstandingV1

• Remove additionalProperties property from CategoriesOptions and MetadataOptions

SpeechToTextV1

• The tokenURL and websocketsURL properties are no longer public. Setting the serviceURL will automatically update the other two URLs appropriately.
• Add missing parameters baseModelVersion, languageCustomizationID, and customerID to the following methods:
  • recognize() (using an audio file)
  • recognizeUsingWebsocket()
  • recognizeMicrophone()
  • SpeechToTextSession() initializers

VisualRecognitionV3

• Remove PositiveExample model. All parameters that used that model are now of type [String: URL]
• Change the following properties from optional to nonoptional
  • ClassResult.score
  • DetectedFaces.imagesProcessed
  • FaceAge.score
  • FaceGender.score

0.38.1 (2018-11-13)

Bug Fixes

• SpeechToTextV1: Update recognizeMicrophone() to work with any authentication method (5701ba6)

0.38.0 (2018-11-12)

Bug Fixes

• VisualRecognitionV3: temporary workaround for new A12 based devices (62edd09)
• VisualRecognitionV3: temporary workaround to support A12 devices for Core ML inference (fa212ec)

Features

• All: Add support for Swift 4.2 (4bbf42b)

0.37.0 (2018-11-02)

Features

• AssistantV1, AssistantV2: Add cloudFunction and webAction to DialogNodeAction.ActionType (16d3fc9)
• DiscoveryV1: Tokenization dictionaries for collections (d274371)
• SpeechToTextV1: Add languageCustomizationID parameter to createJob() and recognize() (0137964)

0.36.0 (2018-10-19)

Bug Fixes

• Visual Recognition: Fix deserialization error in getCoreMlModel (9392b23)
• Conversion of file data to multipart form data (1d46baf)

Features

• Discovery: Add "LT" option to environment sizes (f92fcde)
• Discovery: Add size parameter to updateEnvironment method (725e1d5)
• Discovery: Add bias and loggingOptOut parameters to query methods (8782fc6)
• Discovery: Add requestedSize and searchStatus properties to Environment model (14cdb02)
• ToneAnalyzer: Add ToneID options to ToneChatScore (ac75c92)

Reverts

• AssistantV1: Revert erroneous addition of actions property to OutputData (28efe1e)
• Linux: Remove 30 minute wait from Linux tests (1b4d734)

Adds a new framework for the AssistantV2 service

This release regenerates all services with documentation updates, adds support for IBM Cloud Private authentication, and adds a couple of new properties to Speech to Text and Assistant/Conversation.

• All services: Adds support for authentication with IBM Cloud Private (ICP) API keys. Use the init(username:password:) initializer, passing apikey for the username parameter and the API key for the password.
• Speech to Text: Adds the language models de-DE_BroadbandModel, pt-BR_BroadbandModel, and pt-BR_NarrowbandModel
• Assistant/Conversation: Add the actions property to MessageResponse and OutputData

Internal bug fix regarding RestKit.framework. This should have no impact on users.

First release that supports Cocoapods!

This release adds support for installing each service in the Swift SDK via Cocoapods. It also adds new options to the Speech to Text recognize API, and includes documentation improvements.

• Support for Cocoapods!
• Speech to Text: Adds the acousticCustomizationID and headers parameters to the recognize() method
• Speech to Text: Adds the customizationWeight property to RecognitionSettings
• Documentation: Split README into multiple READMEs: one main README plus one README for each service
• Documentation: Improved Jazzy docs

This release regenerates all services with documentation updates, and adds some new methods to Discovery.

• Discovery: Add ability to create new Events to create log entries associated with specific queries
• Discovery: Add new methods to obtain metrics and metadata on past queries
• Discovery: Changes the type of the size parameter in the createEnvironment method from Int to String.

This release regenerates all services with documentation updates and minor generator improvements.

This release includes the following new features and bug fixes:

• Assistant: Add support for entity mentions and disambiguation
• Renames STT Websocket method to recognizeUsingWebSocket. The prior name is deprecated but retained for backward compatibility.
• Fix Xcode 10 build error

This release regenerates all services with documentation updates and minor generator improvements.

This release includes the following new features and bug fixes:

• Discovery: Add support for credentials and configuration source options
• Add support for websocket features for services using IAM authentication
• Handle malformed URLs when constructing URL requests
• Remove extraneous version param from IAM init methods for LTv2, NLC, STT, TTS

This release regenerates all services with generator updates for error handling and multi-consumes operations.

The release also adds a deprecation notice for the Language Translator v2 service. Users are encouraged to migrate to the new Language Translator v3 service.

This release should be fully compatible with the previous SDK release.

This release regenerates just the NLC service to add support for IAM authentication.

This release regenerates all services. It includes updates to the documentation and some minor new service features.

This release includes the following new features and bug fixes:

• Adds support for the new Language Translator V3 service and deprecates Language Translator V2
• Fix for issue 833

This release regenerates all services. It includes updates to the documentation and some minor new service features.

This release includes the following new features and bug fixes:

• Adds support for IAM authentication, using either an IAM API Key or an access_token obtained using the service API Key

This release regenerates all services. It includes updates to the documentation and some minor new service features.

This release includes the following new features and bug fixes:

• Adds a headers parameter to all service methods that can be used to pass request headers to be sent with the request.
• Adds a deleteUserData method in some services to allow deletion of data associated with a specified customer_id.

This release regenerates all services except for Visual Recognition. It includes considerable updates to the function documentation and model serialization/deserialization, although they should not be breaking changes for users.

This release also includes the following new features and bug fixes:

• Discovery: Adds support for document segmentation
• Natural Language Classifier: Adds support for classifyCollection
• Speech to Text: Adds acoustic model customization
• Speech to Text: Adds enums for BaseModelName
• Tone Analyzer: Fixes a bug with the tones list for the tone function
• Tone Analyzer: Adds contentLanguage parameter to toneChat
• Tone Analyzer: Adds plain-text and HTML variants of the tone function
• Tone Analyzer: Removes unused content-type parameter from the JSON variant of the tone function

This release fixes a bug with SwiftLint and Xcode 9.3 by reducing the severity of the superfluous_disable_command rule to a warning instead of an error.