@typia/vercel 12.0.0-dev.20260225

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# `@typia/vercel`
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
+[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
+[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
+
+[Vercel AI SDK](https://github.com/vercel/ai) integration for [`typia`](https://github.com/samchon/typia).
+
+Converts typia controllers to Vercel AI SDK tools compatible with OpenAI, Anthropic, Google, and other LLM providers.
+
+## Setup
+
+```bash
+npm install @typia/vercel ai
+npm install typia
+npx typia setup
+```
+
+## Usage
+
+### From TypeScript class
+
+```typescript
+import { openai } from "@ai-sdk/openai";
+import { toVercelTools } from "@typia/vercel";
+import { generateText, GenerateTextResult, Tool } from "ai";
+import typia from "typia";
+
+const tools: Record<string, Tool> = toVercelTools({
+  controllers: [
+    typia.llm.controller<Calculator>("Calculator", new Calculator()),
+  ],
+});
+
+const result: GenerateTextResult = await generateText({
+  model: openai("gpt-4o"),
+  prompt: "What is 10 + 5?",
+  tools,
+});
+```
+
+### From OpenAPI document
+
+```typescript
+import { toVercelTools } from "@typia/vercel";
+import { HttpLlm } from "@typia/utils";
+import { Tool } from "ai";
+
+const tools: Record<string, Tool> = toVercelTools({
+  controllers: [
+    HttpLlm.controller({
+      name: "petStore",
+      document: yourOpenApiDocument,
+      connection: { host: "https://api.example.com" },
+    }),
+  ],
+});
+```
+
+## Features
+
+- No manual schema definition — generates everything from TypeScript types or OpenAPI
+- Automatic argument validation with LLM-friendly error feedback
+- Supports both class-based (`typia.llm.controller`) and HTTP-based (`HttpLlm.controller`) controllers
+- Works with any LLM provider supported by Vercel AI SDK

package/lib/index.d.ts

@@ -0,0 +1,97 @@
+import type { Tool } from "ai";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+/**
+ * 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 {@link stringifyValidationFailure}
+ * so the LLM can auto-correct in the next turn.
+ *
+ * ## Example with OpenAI
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import typia from "typia";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * class Calculator {
+ *   /&#42;&#42; Add two numbers together. &#42;/
+ *   add(props: { a: number; b: number }): number {
+ *     return 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?",
+ * });
+ * ```
+ *
+ * ## Example with Anthropic
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * const result = await generateText({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   tools: toVercelTools({ controllers: [controller] }),
+ *   prompt: "Calculate 100 * 50",
+ * });
+ * ```
+ *
+ * ## Example with HTTP Controller (OpenAPI)
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import { HttpLlm } from "@typia/utils";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * 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",
+ * });
+ * ```
+ *
+ * @param props Conversion properties
+ * @returns Record of Vercel AI SDK Tools keyed by tool name
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare function toVercelTools(props: {
+    /**
+     * List of controllers to convert to Vercel tools.
+     *
+     * - {@link ILlmController}: from `typia.llm.controller<Class>()`, converts all
+     *   methods of the class to tools
+     * - {@link IHttpLlmController}: from `HttpLlm.controller()`, converts all
+     *   operations from OpenAPI document to tools
+     */
+    controllers: Array<ILlmController | IHttpLlmController>;
+    /**
+     * Whether to prefix tool names with controller name.
+     *
+     * If `true`, tool names are formatted as `{controller}_{function}`.
+     * If `false`, only the function name is used (may cause conflicts).
+     *
+     * @default true
+     */
+    prefix?: boolean | undefined;
+}): Record<string, Tool>;

package/lib/index.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toVercelTools = toVercelTools;
+const VercelToolsRegistrar_1 = require("./internal/VercelToolsRegistrar");
+/**
+ * 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 {@link stringifyValidationFailure}
+ * so the LLM can auto-correct in the next turn.
+ *
+ * ## Example with OpenAI
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import typia from "typia";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * class Calculator {
+ *   /&#42;&#42; Add two numbers together. &#42;/
+ *   add(props: { a: number; b: number }): number {
+ *     return 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?",
+ * });
+ * ```
+ *
+ * ## Example with Anthropic
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * const result = await generateText({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   tools: toVercelTools({ controllers: [controller] }),
+ *   prompt: "Calculate 100 * 50",
+ * });
+ * ```
+ *
+ * ## Example with HTTP Controller (OpenAPI)
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import { HttpLlm } from "@typia/utils";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * 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",
+ * });
+ * ```
+ *
+ * @param props Conversion properties
+ * @returns Record of Vercel AI SDK Tools keyed by tool name
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+function toVercelTools(props) {
+    return VercelToolsRegistrar_1.VercelToolsRegistrar.convert(props);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAgFA,sCAsBC;AAnGD,0EAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,SAAgB,aAAa,CAAC,KAoB7B;IACC,OAAO,2CAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/lib/index.mjs

@@ -0,0 +1,83 @@
+import { VercelToolsRegistrar } from './internal/VercelToolsRegistrar.mjs';
+
+/**
+ * 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 {@link stringifyValidationFailure}
+ * so the LLM can auto-correct in the next turn.
+ *
+ * ## Example with OpenAI
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import typia from "typia";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * class Calculator {
+ *   /&#42;&#42; Add two numbers together. &#42;/
+ *   add(props: { a: number; b: number }): number {
+ *     return 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?",
+ * });
+ * ```
+ *
+ * ## Example with Anthropic
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * const result = await generateText({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   tools: toVercelTools({ controllers: [controller] }),
+ *   prompt: "Calculate 100 * 50",
+ * });
+ * ```
+ *
+ * ## Example with HTTP Controller (OpenAPI)
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import { HttpLlm } from "@typia/utils";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * 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",
+ * });
+ * ```
+ *
+ * @param props Conversion properties
+ * @returns Record of Vercel AI SDK Tools keyed by tool name
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+function toVercelTools(props) {
+    return VercelToolsRegistrar.convert(props);
+}
+
+export { toVercelTools };
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EG;AACG,SAAU,aAAa,CAAC,KAoB7B,EAAA;AACC,IAAA,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC;AAC5C;;;;"}

package/lib/internal/VercelToolsRegistrar.d.ts

@@ -0,0 +1,14 @@
+import type { Tool } from "ai";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+export declare namespace VercelToolsRegistrar {
+    /**
+     * Convert typia controllers to Vercel AI SDK tools.
+     *
+     * @param props Conversion properties
+     * @returns Record of Vercel AI SDK Tools
+     */
+    const convert: (props: {
+        controllers: Array<ILlmController | IHttpLlmController>;
+        prefix?: boolean | undefined;
+    }) => Record<string, Tool>;
+}

package/lib/internal/VercelToolsRegistrar.js

@@ -0,0 +1,143 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VercelToolsRegistrar = void 0;
+const ai_1 = require("ai");
+const utils_1 = require("@typia/utils");
+var VercelToolsRegistrar;
+(function (VercelToolsRegistrar) {
+    /**
+     * Convert typia controllers to Vercel AI SDK tools.
+     *
+     * @param props Conversion properties
+     * @returns Record of Vercel AI SDK Tools
+     */
+    VercelToolsRegistrar.convert = (props) => {
+        var _a;
+        const tools = {};
+        const prefix = (_a = props.prefix) !== null && _a !== void 0 ? _a : true;
+        for (const controller of props.controllers) {
+            if (controller.protocol === "class") {
+                registerClassController({
+                    tools,
+                    controller,
+                    prefix,
+                });
+            }
+            else {
+                registerHttpController({
+                    tools,
+                    controller,
+                    prefix,
+                });
+            }
+        }
+        return tools;
+    };
+    const registerClassController = (props) => {
+        const { tools, controller, prefix } = props;
+        const execute = controller.execute;
+        for (const func of controller.application.functions) {
+            const toolName = prefix
+                ? `${controller.name}_${func.name}`
+                : func.name;
+            if (tools[toolName] !== undefined) {
+                throw new Error(`Duplicate tool name "${toolName}" from controller "${controller.name}"`);
+            }
+            const method = execute[func.name];
+            if (typeof method !== "function") {
+                throw new Error(`Method "${func.name}" not found on controller "${controller.name}"`);
+            }
+            tools[toolName] = createTool({
+                func,
+                execute: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(execute, args); }),
+            });
+        }
+    };
+    const registerHttpController = (props) => {
+        const { tools, controller, prefix } = props;
+        const application = controller.application;
+        const connection = controller.connection;
+        for (const func of application.functions) {
+            const toolName = prefix
+                ? `${controller.name}_${func.name}`
+                : func.name;
+            if (tools[toolName] !== undefined) {
+                throw new Error(`Duplicate tool name "${toolName}" from controller "${controller.name}"`);
+            }
+            tools[toolName] = createTool({
+                func,
+                execute: (args) => __awaiter(this, void 0, void 0, function* () {
+                    if (controller.execute !== undefined) {
+                        const response = yield controller.execute({
+                            connection,
+                            application,
+                            function: func,
+                            arguments: args,
+                        });
+                        return response.body;
+                    }
+                    return utils_1.HttpLlm.execute({
+                        application,
+                        function: func,
+                        connection,
+                        input: args,
+                    });
+                }),
+            });
+        }
+    };
+    const createTool = (props) => {
+        const { func, execute } = props;
+        return (0, ai_1.tool)({
+            description: func.description,
+            // Convert ILlmSchema.IParameters to Vercel jsonSchema
+            parameters: (0, ai_1.jsonSchema)(convertParameters(func.parameters)),
+            execute: (args) => __awaiter(this, void 0, void 0, function* () {
+                // Validate using typia's built-in validator
+                const validation = func.validate(args);
+                if (!validation.success) {
+                    // Return validation error in LLM-friendly format
+                    return {
+                        error: true,
+                        message: (0, utils_1.stringifyValidationFailure)(validation),
+                    };
+                }
+                try {
+                    const result = yield execute(validation.data);
+                    return result === undefined ? { success: true } : result;
+                }
+                catch (error) {
+                    return {
+                        error: true,
+                        message: error instanceof Error
+                            ? `${error.name}: ${error.message}`
+                            : String(error),
+                    };
+                }
+            }),
+        });
+    };
+    const convertParameters = (params) => {
+        const schema = {
+            type: "object",
+            properties: params.properties,
+            required: params.required,
+            additionalProperties: params.additionalProperties,
+        };
+        // Add $defs if present
+        if (Object.keys(params.$defs).length > 0) {
+            schema.$defs = params.$defs;
+        }
+        return schema;
+    };
+})(VercelToolsRegistrar || (exports.VercelToolsRegistrar = VercelToolsRegistrar = {}));
+//# sourceMappingURL=VercelToolsRegistrar.js.map

package/lib/internal/VercelToolsRegistrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VercelToolsRegistrar.js","sourceRoot":"","sources":["../../src/internal/VercelToolsRegistrar.ts"],"names":[],"mappings":"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"}

package/lib/internal/VercelToolsRegistrar.mjs

@@ -0,0 +1,133 @@
+import { tool, jsonSchema } from 'ai';
+import { stringifyValidationFailure, HttpLlm } from '@typia/utils';
+
+var VercelToolsRegistrar;
+(function (VercelToolsRegistrar) {
+    /**
+     * Convert typia controllers to Vercel AI SDK tools.
+     *
+     * @param props Conversion properties
+     * @returns Record of Vercel AI SDK Tools
+     */
+    VercelToolsRegistrar.convert = (props) => {
+        const tools = {};
+        const prefix = props.prefix ?? true;
+        for (const controller of props.controllers) {
+            if (controller.protocol === "class") {
+                registerClassController({
+                    tools,
+                    controller,
+                    prefix,
+                });
+            }
+            else {
+                registerHttpController({
+                    tools,
+                    controller,
+                    prefix,
+                });
+            }
+        }
+        return tools;
+    };
+    const registerClassController = (props) => {
+        const { tools, controller, prefix } = props;
+        const execute = controller.execute;
+        for (const func of controller.application.functions) {
+            const toolName = prefix
+                ? `${controller.name}_${func.name}`
+                : func.name;
+            if (tools[toolName] !== undefined) {
+                throw new Error(`Duplicate tool name "${toolName}" from controller "${controller.name}"`);
+            }
+            const method = execute[func.name];
+            if (typeof method !== "function") {
+                throw new Error(`Method "${func.name}" not found on controller "${controller.name}"`);
+            }
+            tools[toolName] = createTool({
+                func,
+                execute: async (args) => method.call(execute, args),
+            });
+        }
+    };
+    const registerHttpController = (props) => {
+        const { tools, controller, prefix } = props;
+        const application = controller.application;
+        const connection = controller.connection;
+        for (const func of application.functions) {
+            const toolName = prefix
+                ? `${controller.name}_${func.name}`
+                : func.name;
+            if (tools[toolName] !== undefined) {
+                throw new Error(`Duplicate tool name "${toolName}" from controller "${controller.name}"`);
+            }
+            tools[toolName] = createTool({
+                func,
+                execute: async (args) => {
+                    if (controller.execute !== undefined) {
+                        const response = await controller.execute({
+                            connection,
+                            application,
+                            function: func,
+                            arguments: args,
+                        });
+                        return response.body;
+                    }
+                    return HttpLlm.execute({
+                        application,
+                        function: func,
+                        connection,
+                        input: args,
+                    });
+                },
+            });
+        }
+    };
+    const createTool = (props) => {
+        const { func, execute } = props;
+        return tool({
+            description: func.description,
+            // Convert ILlmSchema.IParameters to Vercel jsonSchema
+            parameters: jsonSchema(convertParameters(func.parameters)),
+            execute: async (args) => {
+                // Validate using typia's built-in validator
+                const validation = func.validate(args);
+                if (!validation.success) {
+                    // Return validation error in LLM-friendly format
+                    return {
+                        error: true,
+                        message: stringifyValidationFailure(validation),
+                    };
+                }
+                try {
+                    const result = await execute(validation.data);
+                    return result === undefined ? { success: true } : result;
+                }
+                catch (error) {
+                    return {
+                        error: true,
+                        message: error instanceof Error
+                            ? `${error.name}: ${error.message}`
+                            : String(error),
+                    };
+                }
+            },
+        });
+    };
+    const convertParameters = (params) => {
+        const schema = {
+            type: "object",
+            properties: params.properties,
+            required: params.required,
+            additionalProperties: params.additionalProperties,
+        };
+        // Add $defs if present
+        if (Object.keys(params.$defs).length > 0) {
+            schema.$defs = params.$defs;
+        }
+        return schema;
+    };
+})(VercelToolsRegistrar || (VercelToolsRegistrar = {}));
+
+export { VercelToolsRegistrar };
+//# sourceMappingURL=VercelToolsRegistrar.mjs.map

package/lib/internal/VercelToolsRegistrar.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"VercelToolsRegistrar.mjs","sources":["../../src/internal/VercelToolsRegistrar.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@typia/vercel",
+  "version": "12.0.0-dev.20260225",
+  "description": "Vercel AI SDK integration for typia",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/typia"
+  },
+  "author": "Jeongho Nam",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/typia/issues"
+  },
+  "homepage": "https://typia.io",
+  "dependencies": {
+    "@typia/interface": "^12.0.0-dev.20260225",
+    "@typia/utils": "^12.0.0-dev.20260225"
+  },
+  "peerDependencies": {
+    "ai": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/json-schema": "^7.0.15",
+    "ai": "^4.3.16",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.56.0",
+    "rollup-plugin-auto-external": "^2.0.0",
+    "rollup-plugin-node-externals": "^8.1.2",
+    "tinyglobby": "^0.2.12",
+    "typescript": "~5.9.3"
+  },
+  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "README.md",
+    "package.json",
+    "lib",
+    "src"
+  ],
+  "keywords": [
+    "vercel",
+    "ai-sdk",
+    "typia",
+    "llm",
+    "llm-function-calling",
+    "ai",
+    "tool-calling",
+    "openai",
+    "anthropic",
+    "claude",
+    "chatgpt",
+    "gemini",
+    "validation",
+    "json-schema",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc && rollup -c",
+    "dev": "rimraf lib && tsc --watch"
+  },
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.ts"
+}

package/src/index.ts

@@ -0,0 +1,103 @@
+import type { Tool } from "ai";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+
+import { VercelToolsRegistrar } from "./internal/VercelToolsRegistrar";
+
+/**
+ * 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 {@link stringifyValidationFailure}
+ * so the LLM can auto-correct in the next turn.
+ *
+ * ## Example with OpenAI
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import typia from "typia";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * class Calculator {
+ *   /&#42;&#42; Add two numbers together. &#42;/
+ *   add(props: { a: number; b: number }): number {
+ *     return 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?",
+ * });
+ * ```
+ *
+ * ## Example with Anthropic
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * const result = await generateText({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   tools: toVercelTools({ controllers: [controller] }),
+ *   prompt: "Calculate 100 * 50",
+ * });
+ * ```
+ *
+ * ## Example with HTTP Controller (OpenAPI)
+ *
+ * ```typescript
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import { HttpLlm } from "@typia/utils";
+ * import { toVercelTools } from "@typia/vercel";
+ *
+ * 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",
+ * });
+ * ```
+ *
+ * @param props Conversion properties
+ * @returns Record of Vercel AI SDK Tools keyed by tool name
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function toVercelTools(props: {
+  /**
+   * List of controllers to convert to Vercel tools.
+   *
+   * - {@link ILlmController}: from `typia.llm.controller<Class>()`, converts all
+   *   methods of the class to tools
+   * - {@link IHttpLlmController}: from `HttpLlm.controller()`, converts all
+   *   operations from OpenAPI document to tools
+   */
+  controllers: Array<ILlmController | IHttpLlmController>;
+
+  /**
+   * Whether to prefix tool names with controller name.
+   *
+   * If `true`, tool names are formatted as `{controller}_{function}`.
+   * If `false`, only the function name is used (may cause conflicts).
+   *
+   * @default true
+   */
+  prefix?: boolean | undefined;
+}): Record<string, Tool> {
+  return VercelToolsRegistrar.convert(props);
+}

package/src/internal/VercelToolsRegistrar.ts

@@ -0,0 +1,179 @@
+import { jsonSchema, tool } from "ai";
+import type { Tool } from "ai";
+import type { JSONSchema7 } from "json-schema";
+import {
+  IHttpLlmController,
+  IHttpLlmFunction,
+  ILlmController,
+  ILlmFunction,
+  ILlmSchema,
+  IValidation,
+} from "@typia/interface";
+import { HttpLlm, stringifyValidationFailure } from "@typia/utils";
+
+export namespace VercelToolsRegistrar {
+  /**
+   * Convert typia controllers to Vercel AI SDK tools.
+   *
+   * @param props Conversion properties
+   * @returns Record of Vercel AI SDK Tools
+   */
+  export const convert = (props: {
+    controllers: Array<ILlmController | IHttpLlmController>;
+    prefix?: boolean | undefined;
+  }): Record<string, Tool> => {
+    const tools: Record<string, Tool> = {};
+    const prefix: boolean = props.prefix ?? true;
+
+    for (const controller of props.controllers) {
+      if (controller.protocol === "class") {
+        registerClassController({
+          tools,
+          controller,
+          prefix,
+        });
+      } else {
+        registerHttpController({
+          tools,
+          controller,
+          prefix,
+        });
+      }
+    }
+
+    return tools;
+  };
+
+  const registerClassController = (props: {
+    tools: Record<string, Tool>;
+    controller: ILlmController;
+    prefix: boolean;
+  }): void => {
+    const { tools, controller, prefix } = props;
+    const execute: Record<string, unknown> = controller.execute;
+
+    for (const func of controller.application.functions) {
+      const toolName: string = prefix
+        ? `${controller.name}_${func.name}`
+        : func.name;
+
+      if (tools[toolName] !== undefined) {
+        throw new Error(
+          `Duplicate tool name "${toolName}" from controller "${controller.name}"`,
+        );
+      }
+
+      const method: unknown = execute[func.name];
+      if (typeof method !== "function") {
+        throw new Error(
+          `Method "${func.name}" not found on controller "${controller.name}"`,
+        );
+      }
+
+      tools[toolName] = createTool({
+        func,
+        execute: async (args: unknown) => method.call(execute, args),
+      });
+    }
+  };
+
+  const registerHttpController = (props: {
+    tools: Record<string, Tool>;
+    controller: IHttpLlmController;
+    prefix: boolean;
+  }): void => {
+    const { tools, controller, prefix } = props;
+    const application = controller.application;
+    const connection = controller.connection;
+
+    for (const func of application.functions) {
+      const toolName: string = prefix
+        ? `${controller.name}_${func.name}`
+        : func.name;
+
+      if (tools[toolName] !== undefined) {
+        throw new Error(
+          `Duplicate tool name "${toolName}" from controller "${controller.name}"`,
+        );
+      }
+
+      tools[toolName] = createTool({
+        func,
+        execute: async (args: unknown) => {
+          if (controller.execute !== undefined) {
+            const response = await controller.execute({
+              connection,
+              application,
+              function: func,
+              arguments: args as object,
+            });
+            return response.body;
+          }
+          return HttpLlm.execute({
+            application,
+            function: func,
+            connection,
+            input: args as object,
+          });
+        },
+      });
+    }
+  };
+
+  const createTool = (props: {
+    func: ILlmFunction | IHttpLlmFunction;
+    execute: (args: unknown) => Promise<unknown>;
+  }): Tool => {
+    const { func, execute } = props;
+
+    return tool({
+      description: func.description,
+
+      // Convert ILlmSchema.IParameters to Vercel jsonSchema
+      parameters: jsonSchema<object>(
+        convertParameters(func.parameters) as JSONSchema7,
+      ),
+
+      execute: async (args: object) => {
+        // Validate using typia's built-in validator
+        const validation: IValidation<unknown> = func.validate(args);
+        if (!validation.success) {
+          // Return validation error in LLM-friendly format
+          return {
+            error: true,
+            message: stringifyValidationFailure(validation),
+          };
+        }
+
+        try {
+          const result: unknown = await execute(validation.data);
+          return result === undefined ? { success: true } : result;
+        } catch (error) {
+          return {
+            error: true,
+            message:
+              error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : String(error),
+          };
+        }
+      },
+    });
+  };
+
+  const convertParameters = (params: ILlmSchema.IParameters): JSONSchema7 => {
+    const schema: JSONSchema7 = {
+      type: "object",
+      properties: params.properties as JSONSchema7["properties"],
+      required: params.required,
+      additionalProperties: params.additionalProperties,
+    };
+
+    // Add $defs if present
+    if (Object.keys(params.$defs).length > 0) {
+      schema.$defs = params.$defs as JSONSchema7["$defs"];
+    }
+
+    return schema;
+  };
+}