September 2023 Summaries

Speakeasy Suggest is an AI-powered tool designed to automate the maintenance and improvement of OpenAPI specifications, helping API companies produce high-quality and human-readable SDKs. By leveraging a Langauge Model (LLM) based agent, Speakeasy Suggest identifies and rectifies misconfigurations within OpenAPI documents, offering solutions through either the Speakeasy CLI or a GitHub workflow. This tool addresses common issues such as duplicate operationIDs, missing examples, and inline object schema redundancies by suggesting and applying JSON patches to the OpenAPI spec. The development process emphasized the need for structured output and validation of suggestions to ensure accuracy and effectiveness, ultimately favoring a custom agent approach over Retrieval Augmented Generation due to its superior handling of complex tasks. Speakeasy aims to integrate software engineering best practices into API spec management, enhancing the reliability and usability of API documentation and SDKs.

The blog post explores the process of wrapping a Terraform provider for use in Pulumi, particularly in light of recent licensing changes by HashiCorp that have prompted many users to consider Pulumi as an alternative. While Terraform utilizes the declarative HashiCorp Configuration Language (HCL), Pulumi supports a range of imperative programming languages, offering users more control but potentially less readability. The article outlines the tools and steps necessary to bridge a Terraform provider into Pulumi, highlighting the use of the Pulumi Terraform Bridge and the Terraform Bridge Provider Boilerplate. It provides detailed instructions for converting providers based on both the Terraform Plugin SDK and the newer Terraform Plugin Framework, using examples involving Spotify and Airbyte providers. The post underscores that while Pulumi currently has fewer providers than Terraform, tools like the Pulumi Terraform Bridge can help close this gap by facilitating the creation of bridge providers. It concludes by suggesting that interested users can engage with Speakeasy for further assistance and to consider joining their Slack community for discussions and expert advice.