Function toVercelTools

Convert typia controllers to Vercel AI SDK tools.

Transforms TypeScript class methods via typia.llm.controller<Class>() or OpenAPI operations via HttpLlm.controller() into Vercel AI SDK tools that can be used with any LLM provider (OpenAI, Anthropic, Google, etc.).

Every tool call is validated by typia. If the LLM provides invalid arguments, returns a validation error formatted by LlmJson.stringify so the LLM can auto-correct in the next turn.

Example with OpenAI

import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
import typia from "typia";
import { toVercelTools } from "@typia/vercel";

class Calculator {
  /** Add two numbers together. */
  add(props: { a: number; b: number }): { value: number } {
    return { value: props.a + props.b };
  }
}

const controller = typia.llm.controller<Calculator>("calc", new Calculator());
const tools = toVercelTools({ controllers: [controller] });

const result = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "What is 15 + 27?",
});
Copy

Example with Anthropic

import { anthropic } from "@ai-sdk/anthropic";
import { toVercelTools } from "@typia/vercel";
import { generateText } from "ai";

const result = await generateText({
  model: anthropic("claude-sonnet-4-20250514"),
  tools: toVercelTools({ controllers: [controller] }),
  prompt: "Calculate 100 * 50",
});
Copy

Example with HTTP Controller (OpenAPI)

import { openai } from "@ai-sdk/openai";
import { HttpLlm } from "@typia/utils";
import { toVercelTools } from "@typia/vercel";
import { generateText } from "ai";

const controller = HttpLlm.controller({
  name: "shopping",
  document: await fetch("https://api.example.com/swagger.json").then(
    (r) => r.json(),
  ),
  connection: { host: "https://api.example.com" },
});

const result = await generateText({
  model: openai("gpt-4o"),
  tools: toVercelTools({ controllers: [controller] }),
  prompt: "Search for laptops under $1000",
});
Copy