@typia/utils

@typia/utils

Utility functions and converters for the typia ecosystem.

Automatically installed as a dependency of typia.

Key Exports

Module	Description
HttpLlm	Create LLM controllers from OpenAPI documents and execute function calls
HttpMigration	HTTP migration utilities
HttpError	HTTP error type
OpenApiConverter	Convert between OpenAPI versions
OpenApiTypeChecker	Type checker for OpenAPI documents
LlmSchemaConverter	Convert JSON Schema to LLM schema
LlmTypeChecker	Type checker for LLM schemas
LlmJson	Parse lenient JSON and format validation errors for LLM-friendly feedback

LlmJson

Parse lenient JSON and format validation errors for LLM-friendly feedback:

import { IValidation } from "@typia/interface";
import { LlmJson } from "@typia/utils";

const validation: IValidation<unknown> = func.validate(llmArguments);
if (validation.success === false) {
  console.log(LlmJson.stringify(validation));
}

Output:

{
  "x": "not a number", // ❌ expected: number
  "y": 5
}

HttpLlm

Create LLM controllers from OpenAPI documents:

import { IHttpLlmController } from "@typia/interface";
import { HttpLlm } from "@typia/utils";

// any OpenAPI version (Swagger 2.0, OpenAPI 3.0/3.1) is accepted
const controller: IHttpLlmController = HttpLlm.controller({
  name: "shopping",
  document: await fetch("https://shopping.example.com/swagger.json").then(r => r.json()),
  connection: {
    host: "https://shopping.example.com",
    headers: { Authorization: "Bearer ..." },
  },
});

// use with @typia/langchain or @typia/vercel
toLangChainTools({ controllers: [controller] });
toVercelTools({ controllers: [controller] });

OpenApiConverter is used internally to normalize any OpenAPI version into a unified format. You can also use it directly:

import { OpenApi, OpenApiV3 } from "@typia/interface";
import { OpenApiConverter } from "@typia/utils";

const emended: OpenApi.IDocument = OpenApiConverter.upgradeDocument(swagger2doc); // Swagger 2.0 → OpenApi
const downgraded: OpenApiV3.IDocument = OpenApiConverter.downgradeDocument(emended, "3.0"); // → OpenAPI 3.0