tool-maker

✦ AI Tool Maker

Turn any OpenAPI spec into AI tools that plug right into your Vercel AI SDK apps.

Usage

Locally using yalc

• install yalc
• in this repo run yalc publish
• in the other repo run yalc link tool-maker

Non-locally

The simplest way you can get started is to run this

npx tool-maker ./path/to/output ./path/to/openapi-spec.json

This will generate a few things for you in your output path:

• The *.gen.ts files are your api client generated from your OpenAPI specs. We use hey-api for that.

• In the tool directory you'll find your AI SDK compatible tools that you can easily import and use. This folder also includes aitm.schema.ts which has all zod schemas used by your tools.

After generating your tools, simply import them like you would with any other module and pass it in your AI SDK tools param.

Configure

By default, we assume that your OpenAPI specs are configured correctly. If that's the case, the client we generate for your APIs should be mostly working fine. However, in many cases you find yourself needing to configure the api client to correctly call your apis. This includes things like the Authorization or Content-Type headers etc.

In that case you need to create a openapi-ts.config.ts file outside of the generated dir path so it does not get overwritten each time you generate the tools.

Here's a started for openapi-ts.config.ts

import type { CreateClientConfig } from "@hey-api/client-fetch";

export const createClientConfig: CreateClientConfig = (config) => ({
  ...config,
  baseUrl: "https://example.com",
});

Then correctly provide the path to this file in the CLI

npx tool-maker ./path/to/output ./path/to/openapi-spec.json -c ./path/to/openapi-ts.config.ts

For more details about the configurations check out these docs.

Publishing

Update version. Run npm publish. Profit.