OpenAPI Tools

import { ToolLoopAgent } from "ai";
import { openai } from "@ai-sdk/openai";
import { createOpenApiTools } from "smthrs/openapi";

const tools = await createOpenApiTools("./petstore.json", {
  baseUrl: "https://api.petstore.example.com",
  auth: { type: "bearer", token: process.env.PETSTORE_TOKEN! },
});

const agent = new ToolLoopAgent({
  model: openai("gpt-5.6-terra"),
  tools,
});

type OpenApiToolsOptions = {
  baseUrl?: string;                  // overrides spec.servers[0].url
  headers?: Record<string, string>;  // merged into every request
  auth?:
    | { type: "apiKey"; name: string; in: "header" | "query"; value: string }
    | { type: "bearer"; token: string }
    | { type: "basic"; username: string; password: string };
  allowedRedirectOrigins?: string[]; // extra origins redirects may follow;
                                     // other cross-origin hops are refused so
                                     // injected auth headers cannot leak
  maxResponseBodyBytes?: number;     // cap on response body bytes, default
                                     // 1 MiB; oversized bodies are rejected
                                     // and the read is cancelled
  include?: string[];                // operationId allowlist
  exclude?: string[];                // operationId blocklist
  namePrefix?: string;               // prefix generated tool names
  operations?: Record<
    string,
    | false
    | {
        include?: boolean;           // false skips this operation
        name?: string;               // agent-facing tool name
        description?: string;        // agent-facing tool description
        responseExamples?: Array<{
          status?: string | number;
          description?: string;
          value: unknown;
        }>;
      }
  >;
};

bunx smthrs openapi generate ./api/openapi.yaml ./src/openapi-tools.js

bunx smthrs openapi list ./api/openapi.yaml