@typia/vercel 12.0.0-dev.20260311 → 12.0.0-dev.20260312

package/lib/index.d.ts

@@ -1,5 +1,5 @@
-import { IHttpLlmController, ILlmController } from "@typia/interface";
-import type { Tool } from "ai";
+import { IHttpLlmController, ILlmController, ILlmSchema } from "@typia/interface";
+import type { Schema, Tool } from "ai";
 /**
  * Convert typia controllers to Vercel AI SDK tools.
  *
@@ -21,8 +21,8 @@ import type { Tool } from "ai";
  *
  * class Calculator {
  *   /** Add two numbers together. */
- *   add(props: { a: number; b: number }): number {
- *     return props.a + props.b;
+ *   add(props: { a: number; b: number }): { value: number } {
+ *     return { value: props.a + props.b };
  *   }
  * }
  *
@@ -93,7 +93,47 @@ export declare function toVercelTools(props: {
      * If `true`, tool names are formatted as `{controller}_{function}`. If
      * `false`, only the function name is used (may cause conflicts).
      *
-     * @default true
+     * @default false
      */
     prefix?: boolean | undefined;
 }): Record<string, Tool>;
+/**
+ * Convert LLM parameters schema to Vercel AI SDK schema format.
+ *
+ * Transforms {@link ILlmSchema.IParameters} into Vercel AI SDK's `Schema` type
+ * for use with `generateObject()`. Use with `typia.llm.structuredOutput<T>()`
+ * or `typia.llm.parameters<T>()`.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { openai } from "@ai-sdk/openai";
+ * import { toVercelSchema } from "@typia/vercel";
+ * import { generateObject } from "ai";
+ * import typia from "typia";
+ *
+ * interface IMember {
+ *   name: string;
+ *   age: number;
+ * }
+ *
+ * const output = typia.llm.structuredOutput<IMember>();
+ * const schema = toVercelSchema(output.parameters);
+ *
+ * const { object } = await generateObject({
+ *   model: openai("gpt-4o"),
+ *   schema,
+ *   prompt: "Generate a member named John who is 30 years old",
+ * });
+ *
+ * const coerced = output.coerce(object);
+ * const result = output.validate(coerced);
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param parameters LLM parameters schema from
+ *   `typia.llm.structuredOutput<T>().parameters` or
+ *   `typia.llm.parameters<T>()`
+ * @returns Vercel AI SDK Schema for `generateObject()`
+ */
+export declare function toVercelSchema(parameters: ILlmSchema.IParameters): Schema<object>;

package/lib/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toVercelTools = toVercelTools;
+exports.toVercelSchema = toVercelSchema;
+const VercelParameterConverter_1 = require("./internal/VercelParameterConverter");
 const VercelToolsRegistrar_1 = require("./internal/VercelToolsRegistrar");
 /**
  * Convert typia controllers to Vercel AI SDK tools.
@@ -23,8 +25,8 @@ const VercelToolsRegistrar_1 = require("./internal/VercelToolsRegistrar");
  *
  * class Calculator {
  *   /** Add two numbers together. */
- *   add(props: { a: number; b: number }): number {
- *     return props.a + props.b;
+ *   add(props: { a: number; b: number }): { value: number } {
+ *     return { value: props.a + props.b };
  *   }
  * }
  *
@@ -82,4 +84,46 @@ const VercelToolsRegistrar_1 = require("./internal/VercelToolsRegistrar");
 function toVercelTools(props) {
     return VercelToolsRegistrar_1.VercelToolsRegistrar.convert(props);
 }
+/**
+ * Convert LLM parameters schema to Vercel AI SDK schema format.
+ *
+ * Transforms {@link ILlmSchema.IParameters} into Vercel AI SDK's `Schema` type
+ * for use with `generateObject()`. Use with `typia.llm.structuredOutput<T>()`
+ * or `typia.llm.parameters<T>()`.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { openai } from "@ai-sdk/openai";
+ * import { toVercelSchema } from "@typia/vercel";
+ * import { generateObject } from "ai";
+ * import typia from "typia";
+ *
+ * interface IMember {
+ *   name: string;
+ *   age: number;
+ * }
+ *
+ * const output = typia.llm.structuredOutput<IMember>();
+ * const schema = toVercelSchema(output.parameters);
+ *
+ * const { object } = await generateObject({
+ *   model: openai("gpt-4o"),
+ *   schema,
+ *   prompt: "Generate a member named John who is 30 years old",
+ * });
+ *
+ * const coerced = output.coerce(object);
+ * const result = output.validate(coerced);
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param parameters LLM parameters schema from
+ *   `typia.llm.structuredOutput<T>().parameters` or
+ *   `typia.llm.parameters<T>()`
+ * @returns Vercel AI SDK Schema for `generateObject()`
+ */
+function toVercelSchema(parameters) {
+    return VercelParameterConverter_1.VercelParameterConverter.convert(parameters);
+}
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAkFA,sCAsBC;AArGD,0EAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,SAAgB,aAAa,CAAC,KAoB7B;IACC,OAAO,2CAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAuFA,sCAsBC;AAyCD,wCAIC;AAnJD,kFAA+E;AAC/E,0EAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,SAAgB,aAAa,CAAC,KAoB7B;IACC,OAAO,2CAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,SAAgB,cAAc,CAC5B,UAAkC;IAElC,OAAO,mDAAwB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/lib/index.mjs

@@ -1,3 +1,4 @@
+import { VercelParameterConverter } from './internal/VercelParameterConverter.mjs';
 import { VercelToolsRegistrar } from './internal/VercelToolsRegistrar.mjs';
 
 /**
@@ -21,8 +22,8 @@ import { VercelToolsRegistrar } from './internal/VercelToolsRegistrar.mjs';
  *
  * class Calculator {
  *   /** Add two numbers together. */
- *   add(props: { a: number; b: number }): number {
- *     return props.a + props.b;
+ *   add(props: { a: number; b: number }): { value: number } {
+ *     return { value: props.a + props.b };
  *   }
  * }
  *
@@ -80,6 +81,48 @@ import { VercelToolsRegistrar } from './internal/VercelToolsRegistrar.mjs';
 function toVercelTools(props) {
     return VercelToolsRegistrar.convert(props);
 }
+/**
+ * Convert LLM parameters schema to Vercel AI SDK schema format.
+ *
+ * Transforms {@link ILlmSchema.IParameters} into Vercel AI SDK's `Schema` type
+ * for use with `generateObject()`. Use with `typia.llm.structuredOutput<T>()`
+ * or `typia.llm.parameters<T>()`.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { openai } from "@ai-sdk/openai";
+ * import { toVercelSchema } from "@typia/vercel";
+ * import { generateObject } from "ai";
+ * import typia from "typia";
+ *
+ * interface IMember {
+ *   name: string;
+ *   age: number;
+ * }
+ *
+ * const output = typia.llm.structuredOutput<IMember>();
+ * const schema = toVercelSchema(output.parameters);
+ *
+ * const { object } = await generateObject({
+ *   model: openai("gpt-4o"),
+ *   schema,
+ *   prompt: "Generate a member named John who is 30 years old",
+ * });
+ *
+ * const coerced = output.coerce(object);
+ * const result = output.validate(coerced);
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param parameters LLM parameters schema from
+ *   `typia.llm.structuredOutput<T>().parameters` or
+ *   `typia.llm.parameters<T>()`
+ * @returns Vercel AI SDK Schema for `generateObject()`
+ */
+function toVercelSchema(parameters) {
+    return VercelParameterConverter.convert(parameters);
+}
 
-export { toVercelTools };
+export { toVercelSchema, toVercelTools };
 //# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EG;AACG,SAAU,aAAa,CAAC,KAoB7B,EAAA;AACC,IAAA,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC;AAC5C;;;;"}
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EG;AACG,SAAU,aAAa,CAAC,KAoB7B,EAAA;AACC,IAAA,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC;AAC5C;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCG;AACG,SAAU,cAAc,CAC5B,UAAkC,EAAA;AAElC,IAAA,OAAO,wBAAwB,CAAC,OAAO,CAAC,UAAU,CAAC;AACrD;;;;"}

package/lib/internal/VercelParameterConverter.d.ts

@@ -0,0 +1,5 @@
+import { ILlmSchema } from "@typia/interface";
+import { Schema } from "ai";
+export declare namespace VercelParameterConverter {
+    const convert: (parameters: ILlmSchema.IParameters) => Schema<object>;
+}

package/lib/internal/VercelParameterConverter.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VercelParameterConverter = void 0;
+const ai_1 = require("ai");
+var VercelParameterConverter;
+(function (VercelParameterConverter) {
+    VercelParameterConverter.convert = (parameters) => (0, ai_1.jsonSchema)(parameters);
+})(VercelParameterConverter || (exports.VercelParameterConverter = VercelParameterConverter = {}));
+//# sourceMappingURL=VercelParameterConverter.js.map

package/lib/internal/VercelParameterConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VercelParameterConverter.js","sourceRoot":"","sources":["../../src/internal/VercelParameterConverter.ts"],"names":[],"mappings":";;;AACA,2BAAwC;AAGxC,IAAiB,wBAAwB,CAGxC;AAHD,WAAiB,wBAAwB;IAC1B,gCAAO,GAAG,CAAC,UAAkC,EAAkB,EAAE,CAC5E,IAAA,eAAU,EAAS,UAAyB,CAAC,CAAC;AAClD,CAAC,EAHgB,wBAAwB,wCAAxB,wBAAwB,QAGxC"}

package/lib/internal/VercelParameterConverter.mjs

@@ -0,0 +1,9 @@
+import { jsonSchema } from 'ai';
+
+var VercelParameterConverter;
+(function (VercelParameterConverter) {
+    VercelParameterConverter.convert = (parameters) => jsonSchema(parameters);
+})(VercelParameterConverter || (VercelParameterConverter = {}));
+
+export { VercelParameterConverter };
+//# sourceMappingURL=VercelParameterConverter.mjs.map

package/lib/internal/VercelParameterConverter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"VercelParameterConverter.mjs","sources":["../../src/internal/VercelParameterConverter.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIM,IAAW;AAAjB,CAAA,UAAiB,wBAAwB,EAAA;IAC1B,wBAAA,CAAA,OAAO,GAAG,CAAC,UAAkC,KACxD,UAAU,CAAS,UAAyB,CAAC;AACjD,CAAC,EAHgB,wBAAwB,KAAxB,wBAAwB,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/internal/VercelToolsRegistrar.d.ts

@@ -1,5 +1,5 @@
 import { IHttpLlmController, ILlmController } from "@typia/interface";
-import type { Tool } from "ai";
+import { Tool } from "ai";
 export declare namespace VercelToolsRegistrar {
     /**
      * Convert typia controllers to Vercel AI SDK tools.

package/lib/internal/VercelToolsRegistrar.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VercelToolsRegistrar = void 0;
 const utils_1 = require("@typia/utils");
 const ai_1 = require("ai");
+const VercelParameterConverter_1 = require("./VercelParameterConverter");
 var VercelToolsRegistrar;
 (function (VercelToolsRegistrar) {
     /**
@@ -22,22 +23,31 @@ var VercelToolsRegistrar;
      */
     VercelToolsRegistrar.convert = (props) => {
         var _a;
+        const prefix = (_a = props.prefix) !== null && _a !== void 0 ? _a : false;
         const tools = {};
-        const prefix = (_a = props.prefix) !== null && _a !== void 0 ? _a : true;
+        // check duplicate tool names
+        if (prefix === false && props.controllers.length >= 2) {
+            const names = new Map();
+            const duplicates = [];
+            for (const controller of props.controllers) {
+                for (const func of controller.application.functions) {
+                    const existing = names.get(func.name);
+                    if (existing !== undefined)
+                        duplicates.push(`"${func.name}" in "${controller.name}" (conflicts with "${existing}")`);
+                    else
+                        names.set(func.name, controller.name);
+                }
+            }
+            if (duplicates.length > 0)
+                throw new Error(`Duplicate tool names found:\n  - ${duplicates.join("\n  - ")}`);
+        }
+        // convert controllers to tools
         for (const controller of props.controllers) {
             if (controller.protocol === "class") {
-                registerClassController({
-                    tools,
-                    controller,
-                    prefix,
-                });
+                registerClassController({ tools, controller, prefix });
             }
             else {
-                registerHttpController({
-                    tools,
-                    controller,
-                    prefix,
-                });
+                registerHttpController({ tools, controller, prefix });
             }
         }
         return tools;
@@ -49,14 +59,12 @@ var VercelToolsRegistrar;
             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({
+                name: toolName,
                 func,
                 execute: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(execute, args); }),
             });
@@ -70,10 +78,8 @@ var VercelToolsRegistrar;
             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({
+                name: toolName,
                 func,
                 execute: (args) => __awaiter(this, void 0, void 0, function* () {
                     if (controller.execute !== undefined) {
@@ -96,30 +102,30 @@ var VercelToolsRegistrar;
         }
     };
     const createTool = (props) => {
-        const { func, execute } = props;
+        var _a;
+        const { name, 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)),
+            description: (_a = func.description) !== null && _a !== void 0 ? _a : "",
+            inputSchema: VercelParameterConverter_1.VercelParameterConverter.convert(func.parameters),
             execute: (args) => __awaiter(this, void 0, void 0, function* () {
-                // Coerce and validate using typia's built-in functions
                 const coerced = utils_1.LlmJson.coerce(args, func.parameters);
                 const validation = func.validate(coerced);
-                if (!validation.success) {
-                    // Return validation error in LLM-friendly format
+                if (!validation.success)
                     return {
-                        error: true,
-                        message: utils_1.LlmJson.stringify(validation),
+                        success: false,
+                        error: `Type errors in "${name}" arguments:\n\n` +
+                            `\`\`\`json\n${utils_1.LlmJson.stringify(validation)}\n\`\`\``,
                     };
-                }
                 try {
                     const result = yield execute(validation.data);
-                    return result === undefined ? { success: true } : result;
+                    return result === undefined
+                        ? { success: true }
+                        : { success: true, data: result };
                 }
                 catch (error) {
                     return {
-                        error: true,
-                        message: error instanceof Error
+                        success: false,
+                        error: error instanceof Error
                             ? `${error.name}: ${error.message}`
                             : String(error),
                     };
@@ -127,18 +133,5 @@ var VercelToolsRegistrar;
             }),
         });
     };
-    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

@@ -1 +1 @@
-{"version":3,"file":"VercelToolsRegistrar.js","sourceRoot":"","sources":["../../src/internal/VercelToolsRegistrar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VercelToolsRegistrar.js","sourceRoot":"","sources":["../../src/internal/VercelToolsRegistrar.ts"],"names":[],"mappings":";;;;;;;;;;;;AAOA,wCAAgD;AAChD,2BAAgC;AAEhC,yEAAsE;AAEtE,IAAiB,oBAAoB,CAqJpC;AArJD,WAAiB,oBAAoB;IACnC;;;;;OAKG;IACU,4BAAO,GAAG,CAAC,KAGvB,EAAwB,EAAE;;QACzB,MAAM,MAAM,GAAY,MAAA,KAAK,CAAC,MAAM,mCAAI,KAAK,CAAC;QAC9C,MAAM,KAAK,GAAyB,EAAE,CAAC;QAEvC,6BAA6B;QAC7B,IAAI,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAa,EAAE,CAAC;YAChC,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC3C,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;oBACpD,MAAM,QAAQ,GAAuB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1D,IAAI,QAAQ,KAAK,SAAS;wBACxB,UAAU,CAAC,IAAI,CACb,IAAI,IAAI,CAAC,IAAI,SAAS,UAAU,CAAC,IAAI,sBAAsB,QAAQ,IAAI,CACxE,CAAC;;wBACC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,oCAAoC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAChE,CAAC;QACN,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACpC,uBAAuB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,sBAAsB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,uBAAuB,GAAG,CAAC,KAIhC,EAAQ,EAAE;QACT,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QAC5C,MAAM,OAAO,GAA4B,UAAU,CAAC,OAAO,CAAC;QAE5D,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAW,MAAM;gBAC7B,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;gBACnC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAEd,MAAM,MAAM,GAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,CAAC,IAAI,8BAA8B,UAAU,CAAC,IAAI,GAAG,CACrE,CAAC;YACJ,CAAC;YAED,KAAK,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;gBAC3B,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,OAAO,EAAE,CAAO,IAAa,EAAE,EAAE,gDAAC,OAAA,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA,GAAA;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,sBAAsB,GAAG,CAAC,KAI/B,EAAQ,EAAE;QACT,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QAEzC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAW,MAAM;gBAC7B,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;gBACnC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAEd,KAAK,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;gBAC3B,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,OAAO,EAAE,CAAO,IAAa,EAAE,EAAE;oBAC/B,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBACrC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;4BACxC,UAAU;4BACV,WAAW;4BACX,QAAQ,EAAE,IAAI;4BACd,SAAS,EAAE,IAAc;yBAC1B,CAAC,CAAC;wBACH,OAAO,QAAQ,CAAC,IAAI,CAAC;oBACvB,CAAC;oBACD,OAAO,eAAO,CAAC,OAAO,CAAC;wBACrB,WAAW;wBACX,QAAQ,EAAE,IAAI;wBACd,UAAU;wBACV,KAAK,EAAE,IAAc;qBACtB,CAAC,CAAC;gBACL,CAAC,CAAA;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,KAInB,EAAQ,EAAE;;QACT,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAEtC,OAAO,IAAA,SAAI,EAAC;YACV,WAAW,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,EAAE;YACnC,WAAW,EAAE,mDAAwB,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAC9D,OAAO,EAAE,CAAO,IAAa,EAAuB,EAAE;gBACpD,MAAM,OAAO,GAAY,eAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC/D,MAAM,UAAU,GAAyB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChE,IAAI,CAAC,UAAU,CAAC,OAAO;oBACrB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EACH,mBAAmB,IAAI,kBAAkB;4BACzC,eAAe,eAAO,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU;qBACpC,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBACvD,OAAO,MAAM,KAAK,SAAS;wBACzB,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAAwB;wBAC1C,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAwB,CAAC;gBAC7D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EACH,KAAK,YAAY,KAAK;4BACpB,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE;4BACnC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACC,CAAC;gBACzB,CAAC;YACH,CAAC,CAAA;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,EArJgB,oBAAoB,oCAApB,oBAAoB,QAqJpC"}

package/lib/internal/VercelToolsRegistrar.mjs

@@ -1,5 +1,6 @@
 import { LlmJson, HttpLlm } from '@typia/utils';
-import { tool, jsonSchema } from 'ai';
+import { tool } from 'ai';
+import { VercelParameterConverter } from './VercelParameterConverter.mjs';
 
 var VercelToolsRegistrar;
 (function (VercelToolsRegistrar) {
@@ -10,22 +11,31 @@ var VercelToolsRegistrar;
      * @returns Record of Vercel AI SDK Tools
      */
     VercelToolsRegistrar.convert = (props) => {
+        const prefix = props.prefix ?? false;
         const tools = {};
-        const prefix = props.prefix ?? true;
+        // check duplicate tool names
+        if (prefix === false && props.controllers.length >= 2) {
+            const names = new Map();
+            const duplicates = [];
+            for (const controller of props.controllers) {
+                for (const func of controller.application.functions) {
+                    const existing = names.get(func.name);
+                    if (existing !== undefined)
+                        duplicates.push(`"${func.name}" in "${controller.name}" (conflicts with "${existing}")`);
+                    else
+                        names.set(func.name, controller.name);
+                }
+            }
+            if (duplicates.length > 0)
+                throw new Error(`Duplicate tool names found:\n  - ${duplicates.join("\n  - ")}`);
+        }
+        // convert controllers to tools
         for (const controller of props.controllers) {
             if (controller.protocol === "class") {
-                registerClassController({
-                    tools,
-                    controller,
-                    prefix,
-                });
+                registerClassController({ tools, controller, prefix });
             }
             else {
-                registerHttpController({
-                    tools,
-                    controller,
-                    prefix,
-                });
+                registerHttpController({ tools, controller, prefix });
             }
         }
         return tools;
@@ -37,14 +47,12 @@ var VercelToolsRegistrar;
             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({
+                name: toolName,
                 func,
                 execute: async (args) => method.call(execute, args),
             });
@@ -58,10 +66,8 @@ var VercelToolsRegistrar;
             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({
+                name: toolName,
                 func,
                 execute: async (args) => {
                     if (controller.execute !== undefined) {
@@ -84,30 +90,29 @@ var VercelToolsRegistrar;
         }
     };
     const createTool = (props) => {
-        const { func, execute } = props;
+        const { name, func, execute } = props;
         return tool({
-            description: func.description,
-            // Convert ILlmSchema.IParameters to Vercel jsonSchema
-            parameters: jsonSchema(convertParameters(func.parameters)),
+            description: func.description ?? "",
+            inputSchema: VercelParameterConverter.convert(func.parameters),
             execute: async (args) => {
-                // Coerce and validate using typia's built-in functions
                 const coerced = LlmJson.coerce(args, func.parameters);
                 const validation = func.validate(coerced);
-                if (!validation.success) {
-                    // Return validation error in LLM-friendly format
+                if (!validation.success)
                     return {
-                        error: true,
-                        message: LlmJson.stringify(validation),
+                        success: false,
+                        error: `Type errors in "${name}" arguments:\n\n` +
+                            `\`\`\`json\n${LlmJson.stringify(validation)}\n\`\`\``,
                     };
-                }
                 try {
                     const result = await execute(validation.data);
-                    return result === undefined ? { success: true } : result;
+                    return result === undefined
+                        ? { success: true }
+                        : { success: true, data: result };
                 }
                 catch (error) {
                     return {
-                        error: true,
-                        message: error instanceof Error
+                        success: false,
+                        error: error instanceof Error
                             ? `${error.name}: ${error.message}`
                             : String(error),
                     };
@@ -115,19 +120,6 @@ var VercelToolsRegistrar;
             },
         });
     };
-    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 };

package/lib/internal/VercelToolsRegistrar.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typia/vercel",
-  "version": "12.0.0-dev.20260311",
+  "version": "12.0.0-dev.20260312",
   "description": "Vercel AI SDK integration for typia",
   "main": "lib/index.js",
   "exports": {
@@ -22,18 +22,18 @@
   },
   "homepage": "https://typia.io",
   "dependencies": {
-    "@typia/utils": "^12.0.0-dev.20260311",
-    "@typia/interface": "^12.0.0-dev.20260311"
+    "@typia/interface": "^12.0.0-dev.20260312",
+    "@typia/utils": "^12.0.0-dev.20260312"
   },
   "peerDependencies": {
-    "ai": ">=4.0.0"
+    "ai": ">=6.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",
+    "ai": "^6.0.116",
     "rimraf": "^6.1.2",
     "rollup": "^4.56.0",
     "rollup-plugin-auto-external": "^2.0.0",

package/src/index.ts

@@ -1,105 +1,155 @@
-import { IHttpLlmController, ILlmController } from "@typia/interface";
-import type { Tool } from "ai";
-
-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 LlmJson.stringify} 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 { 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",
- * });
- * ```
- *
- * ## Example with HTTP Controller (OpenAPI)
- *
- * ```typescript
- * 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",
- * });
- * ```
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @param props Conversion properties
- * @returns Record of Vercel AI SDK Tools keyed by tool name
- */
-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);
-}
+import {
+  IHttpLlmController,
+  ILlmController,
+  ILlmSchema,
+} from "@typia/interface";
+import type { Schema, Tool } from "ai";
+
+import { VercelParameterConverter } from "./internal/VercelParameterConverter";
+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 LlmJson.stringify} 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 }): { 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?",
+ * });
+ * ```
+ *
+ * ## Example with Anthropic
+ *
+ * ```typescript
+ * 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",
+ * });
+ * ```
+ *
+ * ## Example with HTTP Controller (OpenAPI)
+ *
+ * ```typescript
+ * 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",
+ * });
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param props Conversion properties
+ * @returns Record of Vercel AI SDK Tools keyed by tool name
+ */
+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 false
+   */
+  prefix?: boolean | undefined;
+}): Record<string, Tool> {
+  return VercelToolsRegistrar.convert(props);
+}
+
+/**
+ * Convert LLM parameters schema to Vercel AI SDK schema format.
+ *
+ * Transforms {@link ILlmSchema.IParameters} into Vercel AI SDK's `Schema` type
+ * for use with `generateObject()`. Use with `typia.llm.structuredOutput<T>()`
+ * or `typia.llm.parameters<T>()`.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { openai } from "@ai-sdk/openai";
+ * import { toVercelSchema } from "@typia/vercel";
+ * import { generateObject } from "ai";
+ * import typia from "typia";
+ *
+ * interface IMember {
+ *   name: string;
+ *   age: number;
+ * }
+ *
+ * const output = typia.llm.structuredOutput<IMember>();
+ * const schema = toVercelSchema(output.parameters);
+ *
+ * const { object } = await generateObject({
+ *   model: openai("gpt-4o"),
+ *   schema,
+ *   prompt: "Generate a member named John who is 30 years old",
+ * });
+ *
+ * const coerced = output.coerce(object);
+ * const result = output.validate(coerced);
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param parameters LLM parameters schema from
+ *   `typia.llm.structuredOutput<T>().parameters` or
+ *   `typia.llm.parameters<T>()`
+ * @returns Vercel AI SDK Schema for `generateObject()`
+ */
+export function toVercelSchema(
+  parameters: ILlmSchema.IParameters,
+): Schema<object> {
+  return VercelParameterConverter.convert(parameters);
+}

package/src/internal/VercelParameterConverter.ts

@@ -0,0 +1,8 @@
+import { ILlmSchema } from "@typia/interface";
+import { Schema, jsonSchema } from "ai";
+import { JSONSchema7 } from "json-schema";
+
+export namespace VercelParameterConverter {
+  export const convert = (parameters: ILlmSchema.IParameters): Schema<object> =>
+    jsonSchema<object>(parameters as JSONSchema7);
+}

package/src/internal/VercelToolsRegistrar.ts

@@ -1,180 +1,166 @@
-import {
-  IHttpLlmController,
-  IHttpLlmFunction,
-  ILlmController,
-  ILlmFunction,
-  ILlmSchema,
-  IValidation,
-} from "@typia/interface";
-import { HttpLlm, LlmJson } from "@typia/utils";
-import { jsonSchema, tool } from "ai";
-import type { Tool } from "ai";
-import type { JSONSchema7 } from "json-schema";
-
-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) => {
-        // Coerce and validate using typia's built-in functions
-        const coerced: unknown = LlmJson.coerce(args, func.parameters);
-        const validation: IValidation<unknown> = func.validate(coerced);
-        if (!validation.success) {
-          // Return validation error in LLM-friendly format
-          return {
-            error: true,
-            message: LlmJson.stringify(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;
-  };
-}
+import {
+  IHttpLlmController,
+  IHttpLlmFunction,
+  ILlmController,
+  ILlmFunction,
+  IValidation,
+} from "@typia/interface";
+import { HttpLlm, LlmJson } from "@typia/utils";
+import { Tool, tool } from "ai";
+
+import { VercelParameterConverter } from "./VercelParameterConverter";
+
+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 prefix: boolean = props.prefix ?? false;
+    const tools: Record<string, Tool> = {};
+
+    // check duplicate tool names
+    if (prefix === false && props.controllers.length >= 2) {
+      const names: Map<string, string> = new Map();
+      const duplicates: string[] = [];
+      for (const controller of props.controllers) {
+        for (const func of controller.application.functions) {
+          const existing: string | undefined = names.get(func.name);
+          if (existing !== undefined)
+            duplicates.push(
+              `"${func.name}" in "${controller.name}" (conflicts with "${existing}")`,
+            );
+          else names.set(func.name, controller.name);
+        }
+      }
+      if (duplicates.length > 0)
+        throw new Error(
+          `Duplicate tool names found:\n  - ${duplicates.join("\n  - ")}`,
+        );
+    }
+
+    // convert controllers to tools
+    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;
+
+      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({
+        name: toolName,
+        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;
+
+      tools[toolName] = createTool({
+        name: toolName,
+        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: {
+    name: string;
+    func: ILlmFunction | IHttpLlmFunction;
+    execute: (args: unknown) => Promise<unknown>;
+  }): Tool => {
+    const { name, func, execute } = props;
+
+    return tool({
+      description: func.description ?? "",
+      inputSchema: VercelParameterConverter.convert(func.parameters),
+      execute: async (args: unknown): Promise<ITryResult> => {
+        const coerced: unknown = LlmJson.coerce(args, func.parameters);
+        const validation: IValidation<unknown> = func.validate(coerced);
+        if (!validation.success)
+          return {
+            success: false,
+            error:
+              `Type errors in "${name}" arguments:\n\n` +
+              `\`\`\`json\n${LlmJson.stringify(validation)}\n\`\`\``,
+          } satisfies ITryResult;
+        try {
+          const result: unknown = await execute(validation.data);
+          return result === undefined
+            ? ({ success: true } satisfies ITryResult)
+            : ({ success: true, data: result } satisfies ITryResult);
+        } catch (error) {
+          return {
+            success: false,
+            error:
+              error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : String(error),
+          } satisfies ITryResult;
+        }
+      },
+    });
+  };
+}
+
+type ITryResult =
+  | { success: true; data?: unknown | undefined }
+  | { success: false; error: string };