@typia/langchain 13.1.1 → 13.2.0

package/lib/index.d.cts

@@ -0,0 +1,66 @@
+import type { DynamicStructuredTool } from "@langchain/core/tools";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+type ILangChainController = ILlmController | IHttpLlmController;
+interface ILangChainToolsOptions {
+    /**
+     * Whether to add controller name as prefix to tool names.
+     *
+     * If `true`, tool names become `{controllerName}_{methodName}`. If `false`,
+     * tool names are just `{methodName}`.
+     *
+     * @default false
+     */
+    prefix?: boolean | undefined;
+}
+interface ILangChainToolsProps extends ILangChainToolsOptions {
+    /**
+     * List of controllers to convert to LangChain 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: ILangChainController[];
+}
+/**
+ * Convert typia controllers to LangChain tools.
+ *
+ * Converts TypeScript class methods via `typia.llm.controller<Class>()` or
+ * OpenAPI operations via `HttpLlm.controller()` to LangChain tools.
+ *
+ * Every tool call is validated by typia. If LLM provides invalid arguments,
+ * returns validation error formatted by {@link LlmJson.stringify} so that LLM
+ * can correct them automatically.
+ *
+ * @example
+ *   ```typescript
+ *   import { initChatModel } from "langchain/chat_models/universal";
+ *   import typia from "typia";
+ *   import { toLangChainTools } from "@typia/langchain";
+ *
+ *   class Calculator {
+ *     add(input: { a: number; b: number }): { value: number } {
+ *       return { value: input.a + input.b };
+ *     }
+ *   }
+ *
+ *   const controller = typia.llm.controller<Calculator>(
+ *     "calculator",
+ *     new Calculator(),
+ *   );
+ *   const tools = toLangChainTools(controller);
+ *
+ *   const llm = await initChatModel();
+ *   const modelWithTools = llm.bindTools(tools);
+ *   const result = await modelWithTools.invoke("What is 10 + 5?");
+ *   ```;
+ *
+ * @param input Controller, controller list, or conversion properties
+ * @param options Conversion options when `input` is not a properties object
+ * @returns Array of LangChain DynamicStructuredTool
+ */
+export declare function toLangChainTools(controller: ILangChainController, options?: ILangChainToolsOptions | undefined): DynamicStructuredTool[];
+export declare function toLangChainTools(controllers: ILangChainController[], options?: ILangChainToolsOptions | undefined): DynamicStructuredTool[];
+export declare function toLangChainTools(props: ILangChainToolsProps): DynamicStructuredTool[];
+export {};

package/lib/index.d.mts

@@ -0,0 +1,66 @@
+import type { DynamicStructuredTool } from "@langchain/core/tools";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+type ILangChainController = ILlmController | IHttpLlmController;
+interface ILangChainToolsOptions {
+    /**
+     * Whether to add controller name as prefix to tool names.
+     *
+     * If `true`, tool names become `{controllerName}_{methodName}`. If `false`,
+     * tool names are just `{methodName}`.
+     *
+     * @default false
+     */
+    prefix?: boolean | undefined;
+}
+interface ILangChainToolsProps extends ILangChainToolsOptions {
+    /**
+     * List of controllers to convert to LangChain 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: ILangChainController[];
+}
+/**
+ * Convert typia controllers to LangChain tools.
+ *
+ * Converts TypeScript class methods via `typia.llm.controller<Class>()` or
+ * OpenAPI operations via `HttpLlm.controller()` to LangChain tools.
+ *
+ * Every tool call is validated by typia. If LLM provides invalid arguments,
+ * returns validation error formatted by {@link LlmJson.stringify} so that LLM
+ * can correct them automatically.
+ *
+ * @example
+ *   ```typescript
+ *   import { initChatModel } from "langchain/chat_models/universal";
+ *   import typia from "typia";
+ *   import { toLangChainTools } from "@typia/langchain";
+ *
+ *   class Calculator {
+ *     add(input: { a: number; b: number }): { value: number } {
+ *       return { value: input.a + input.b };
+ *     }
+ *   }
+ *
+ *   const controller = typia.llm.controller<Calculator>(
+ *     "calculator",
+ *     new Calculator(),
+ *   );
+ *   const tools = toLangChainTools(controller);
+ *
+ *   const llm = await initChatModel();
+ *   const modelWithTools = llm.bindTools(tools);
+ *   const result = await modelWithTools.invoke("What is 10 + 5?");
+ *   ```;
+ *
+ * @param input Controller, controller list, or conversion properties
+ * @param options Conversion options when `input` is not a properties object
+ * @returns Array of LangChain DynamicStructuredTool
+ */
+export declare function toLangChainTools(controller: ILangChainController, options?: ILangChainToolsOptions | undefined): DynamicStructuredTool[];
+export declare function toLangChainTools(controllers: ILangChainController[], options?: ILangChainToolsOptions | undefined): DynamicStructuredTool[];
+export declare function toLangChainTools(props: ILangChainToolsProps): DynamicStructuredTool[];
+export {};

package/lib/internal/LangChainParameterConverter.d.ts

@@ -0,0 +1,37 @@
+import { StandardJSONSchemaV1 } from "@standard-schema/spec";
+import { IHttpLlmFunction, ILlmFunction } from "@typia/interface";
+/**
+ * A Standard JSON Schema view of one typia function's parameters.
+ *
+ * LangChain's tool `schema` fills two roles at once:
+ * `toJsonSchema(tool.schema)` turns it into the parameters the model is shown,
+ * and `StructuredTool.call` validates incoming arguments against it before the
+ * tool body runs. Handing over a bare `ILlmSchema.IParameters` fills the first
+ * role but forfeits the second — LangChain validates it with
+ * `@cfworker/json-schema`, which rejects what typia would have coerced and
+ * reports the failure in its own words, so typia's coercion and its correctable
+ * feedback both become unreachable.
+ *
+ * Standard JSON Schema separates the two roles. It carries a model-facing
+ * schema under `~standard.jsonSchema` and, by declaring no
+ * `~standard.validate`, no validator — which is exactly typia's position: show
+ * the model this schema, and leave validation to `LlmJson.validateArguments` in
+ * the tool body. LangChain reads the schema back through its own
+ * `toJsonSchema`, so the model sees the same parameters document as before,
+ * byte for byte.
+ *
+ * `@typia/vercel` states the same contract to the AI SDK through
+ * `jsonSchema()`, whose `validate` is likewise left undefined so that
+ * `safeValidateTypes` short-circuits its own validation.
+ *
+ * Two version floors hold this together, and both are pinned in the package
+ * manifest. `toJsonSchema` only reads `~standard.jsonSchema` from
+ * `@langchain/core@1.1.30` onwards — older versions return the wrapper itself
+ * and would advertise _that_ to the model in place of the parameters — and
+ * `StandardJSONSchemaV1` only exists from `@standard-schema/spec@1.1.0`.
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ */
+export declare namespace LangChainParameterConverter {
+    const convert: (func: ILlmFunction | IHttpLlmFunction) => StandardJSONSchemaV1;
+}

package/lib/internal/LangChainParameterConverter.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangChainParameterConverter = void 0;
+/**
+ * A Standard JSON Schema view of one typia function's parameters.
+ *
+ * LangChain's tool `schema` fills two roles at once:
+ * `toJsonSchema(tool.schema)` turns it into the parameters the model is shown,
+ * and `StructuredTool.call` validates incoming arguments against it before the
+ * tool body runs. Handing over a bare `ILlmSchema.IParameters` fills the first
+ * role but forfeits the second — LangChain validates it with
+ * `@cfworker/json-schema`, which rejects what typia would have coerced and
+ * reports the failure in its own words, so typia's coercion and its correctable
+ * feedback both become unreachable.
+ *
+ * Standard JSON Schema separates the two roles. It carries a model-facing
+ * schema under `~standard.jsonSchema` and, by declaring no
+ * `~standard.validate`, no validator — which is exactly typia's position: show
+ * the model this schema, and leave validation to `LlmJson.validateArguments` in
+ * the tool body. LangChain reads the schema back through its own
+ * `toJsonSchema`, so the model sees the same parameters document as before,
+ * byte for byte.
+ *
+ * `@typia/vercel` states the same contract to the AI SDK through
+ * `jsonSchema()`, whose `validate` is likewise left undefined so that
+ * `safeValidateTypes` short-circuits its own validation.
+ *
+ * Two version floors hold this together, and both are pinned in the package
+ * manifest. `toJsonSchema` only reads `~standard.jsonSchema` from
+ * `@langchain/core@1.1.30` onwards — older versions return the wrapper itself
+ * and would advertise _that_ to the model in place of the parameters — and
+ * `StandardJSONSchemaV1` only exists from `@standard-schema/spec@1.1.0`.
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ */
+var LangChainParameterConverter;
+(function (LangChainParameterConverter) {
+    LangChainParameterConverter.convert = (func) => {
+        // Coercion never changes the shape a value must end up in, so the input and
+        // output schemas are the same document.
+        const jsonSchema = () => func.parameters;
+        return {
+            "~standard": {
+                version: 1,
+                vendor: "typia",
+                jsonSchema: {
+                    input: jsonSchema,
+                    output: jsonSchema,
+                },
+            },
+        };
+    };
+})(LangChainParameterConverter || (exports.LangChainParameterConverter = LangChainParameterConverter = {}));
+//# sourceMappingURL=LangChainParameterConverter.js.map

package/lib/internal/LangChainParameterConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangChainParameterConverter.js","sourceRoot":"","sources":["../../src/internal/LangChainParameterConverter.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,IAAiB,2BAA2B,CAmB3C;AAnBD,WAAiB,2BAA2B;IAC7B,mCAAO,GAAG,CACrB,IAAqC,EACf,EAAE;QACxB,4EAA4E;QAC5E,wCAAwC;QACxC,MAAM,UAAU,GAAG,GAA4B,EAAE,CAC/C,IAAI,CAAC,UAAgD,CAAC;QACxD,OAAO;YACL,WAAW,EAAE;gBACX,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE;oBACV,KAAK,EAAE,UAAU;oBACjB,MAAM,EAAE,UAAU;iBACnB;aACF;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EAnBgB,2BAA2B,aAA3B,2BAA2B,GAA3B,2BAA2B,QAmB3C"}

package/lib/internal/LangChainParameterConverter.mjs

@@ -0,0 +1,19 @@
+//#region src/internal/LangChainParameterConverter.ts
+let LangChainParameterConverter;
+(function(_LangChainParameterConverter) {
+	_LangChainParameterConverter.convert = (func) => {
+		const jsonSchema = () => func.parameters;
+		return { "~standard": {
+			version: 1,
+			vendor: "typia",
+			jsonSchema: {
+				input: jsonSchema,
+				output: jsonSchema
+			}
+		} };
+	};
+})(LangChainParameterConverter || (LangChainParameterConverter = {}));
+//#endregion
+export { LangChainParameterConverter };
+
+//# sourceMappingURL=LangChainParameterConverter.mjs.map

package/lib/internal/LangChainParameterConverter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangChainParameterConverter.mjs","names":[],"sources":["../../src/internal/LangChainParameterConverter.ts"],"sourcesContent":["import { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport { IHttpLlmFunction, ILlmFunction } from \"@typia/interface\";\n\n/**\n * A Standard JSON Schema view of one typia function's parameters.\n *\n * LangChain's tool `schema` fills two roles at once:\n * `toJsonSchema(tool.schema)` turns it into the parameters the model is shown,\n * and `StructuredTool.call` validates incoming arguments against it before the\n * tool body runs. Handing over a bare `ILlmSchema.IParameters` fills the first\n * role but forfeits the second — LangChain validates it with\n * `@cfworker/json-schema`, which rejects what typia would have coerced and\n * reports the failure in its own words, so typia's coercion and its correctable\n * feedback both become unreachable.\n *\n * Standard JSON Schema separates the two roles. It carries a model-facing\n * schema under `~standard.jsonSchema` and, by declaring no\n * `~standard.validate`, no validator — which is exactly typia's position: show\n * the model this schema, and leave validation to `LlmJson.validateArguments` in\n * the tool body. LangChain reads the schema back through its own\n * `toJsonSchema`, so the model sees the same parameters document as before,\n * byte for byte.\n *\n * `@typia/vercel` states the same contract to the AI SDK through\n * `jsonSchema()`, whose `validate` is likewise left undefined so that\n * `safeValidateTypes` short-circuits its own validation.\n *\n * Two version floors hold this together, and both are pinned in the package\n * manifest. `toJsonSchema` only reads `~standard.jsonSchema` from\n * `@langchain/core@1.1.30` onwards — older versions return the wrapper itself\n * and would advertise _that_ to the model in place of the parameters — and\n * `StandardJSONSchemaV1` only exists from `@standard-schema/spec@1.1.0`.\n *\n * @see https://github.com/standard-schema/standard-schema\n */\nexport namespace LangChainParameterConverter {\n  export const convert = (\n    func: ILlmFunction | IHttpLlmFunction,\n  ): StandardJSONSchemaV1 => {\n    // Coercion never changes the shape a value must end up in, so the input and\n    // output schemas are the same document.\n    const jsonSchema = (): Record<string, unknown> =>\n      func.parameters as unknown as Record<string, unknown>;\n    return {\n      \"~standard\": {\n        version: 1,\n        vendor: \"typia\",\n        jsonSchema: {\n          input: jsonSchema,\n          output: jsonSchema,\n        },\n      },\n    };\n  };\n}\n"],"mappings":";AAmCO,IAAA;;yCAEH,SACyB;EAGzB,MAAM,mBACJ,KAAK;EACP,OAAO,EACL,aAAa;GACX,SAAS;GACT,QAAQ;GACR,YAAY;IACV,OAAO;IACP,QAAQ;GACV;EACF,EACF;CACF;GACD,gCAAA,8BAAA,CAAA,EAAD"}

package/lib/internal/LangChainToolsRegistrar.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LangChainToolsRegistrar = void 0;
 const tools_1 = require("@langchain/core/tools");
 const utils_1 = require("@typia/utils");
+const LangChainParameterConverter_1 = require("./LangChainParameterConverter");
 var LangChainToolsRegistrar;
 (function (LangChainToolsRegistrar) {
     LangChainToolsRegistrar.convert = (props) => {
@@ -19,16 +20,18 @@ var LangChainToolsRegistrar;
         const prefix = (_a = props.prefix) !== null && _a !== void 0 ? _a : false;
         const tools = [];
         // check duplicate tool names
-        if (prefix === false && props.controllers.length >= 2) {
+        if (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);
+                    const toolName = getToolName(controller.name, func.name, prefix);
+                    const existing = names.get(toolName);
+                    const origin = `${controller.protocol} controller "${controller.name}" function "${func.name}"`;
                     if (existing !== undefined)
-                        duplicates.push(`"${func.name}" in "${controller.name}" (conflicts with "${existing}")`);
+                        duplicates.push(`"${toolName}" from ${origin} (conflicts with ${existing})`);
                     else
-                        names.set(func.name, controller.name);
+                        names.set(toolName, origin);
                 }
             }
             if (duplicates.length > 0)
@@ -48,9 +51,7 @@ var LangChainToolsRegistrar;
     const convertClassController = (tools, controller, prefix) => {
         const execute = controller.execute;
         for (const func of controller.application.functions) {
-            const toolName = prefix
-                ? `${controller.name}_${func.name}`
-                : func.name;
+            const toolName = getToolName(controller.name, func.name, prefix);
             const method = execute[func.name];
             if (typeof method !== "function") {
                 throw new Error(`Method "${func.name}" not found on controller "${controller.name}"`);
@@ -58,6 +59,7 @@ var LangChainToolsRegistrar;
             tools.push(createTool({
                 name: toolName,
                 function: func,
+                config: controller.application.config,
                 execute: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(execute, args); }),
             }));
         }
@@ -66,12 +68,11 @@ var LangChainToolsRegistrar;
         const application = controller.application;
         const connection = controller.connection;
         for (const func of application.functions) {
-            const toolName = prefix
-                ? `${controller.name}_${func.name}`
-                : func.name;
+            const toolName = getToolName(controller.name, func.name, prefix);
             tools.push(createTool({
                 name: toolName,
                 function: func,
+                config: application.config,
                 execute: (args) => __awaiter(this, void 0, void 0, function* () {
                     if (controller.execute !== undefined) {
                         const response = yield controller.execute({
@@ -92,35 +93,68 @@ var LangChainToolsRegistrar;
             }));
         }
     };
-    const createTool = (entry) => { var _a; return (0, tools_1.tool)((args) => __awaiter(this, void 0, void 0, function* () {
-        const valid = utils_1.LlmJson.validateArguments(entry.function, args !== null && args !== void 0 ? args : {});
-        if (valid.success === false)
-            throw new tools_1.ToolInputParsingException(`Type errors in "${entry.name}" arguments:\n\n` +
-                `\`\`\`json\n${utils_1.LlmJson.stringify(valid)}\n\`\`\``, JSON.stringify(args !== null && args !== void 0 ? args : {}));
-        try {
-            const result = yield entry.execute(valid.data);
-            if (result === undefined) {
-                return entry.function.output === undefined
-                    ? { success: true }
-                    : {
-                        success: false,
-                        error: `Function "${entry.name}" returned undefined despite declaring an output schema`,
-                    };
+    const createTool = (entry) => {
+        var _a;
+        // A declared return type is a promise to the model, so a result that breaks
+        // it is reported rather than delivered. `@typia/mcp` and `@typia/vercel`
+        // already refuse one; this tool consulted `output` for its existence alone,
+        // so a method returning nothing was reported while a method returning the
+        // wrong shape was not (#2302).
+        //
+        // The application's own config decides how the schema is read back: a
+        // strict application carries its constraints as description tags instead of
+        // keywords, and only that config tells the inverter to read them.
+        const validateOutput = entry.function.output === undefined
+            ? undefined
+            : utils_1.LlmJson.validate(entry.function.output, true, entry.config);
+        return (0, tools_1.tool)((args) => __awaiter(this, void 0, void 0, function* () {
+            const valid = utils_1.LlmJson.validateArguments(entry.function, args !== null && args !== void 0 ? args : {});
+            if (valid.success === false)
+                throw new tools_1.ToolInputParsingException(`Type errors in "${entry.name}" arguments:\n\n` +
+                    utils_1.LlmJson.stringify(valid), JSON.stringify(args !== null && args !== void 0 ? args : {}));
+            try {
+                const result = yield entry.execute(valid.data);
+                if (result === undefined) {
+                    return validateOutput === undefined
+                        ? { success: true }
+                        : {
+                            success: false,
+                            error: `Function "${entry.name}" returned undefined despite declaring an output schema`,
+                        };
+                }
+                if (validateOutput !== undefined) {
+                    const output = validateOutput(result);
+                    if (output.success === false)
+                        return {
+                            success: false,
+                            error: `Type errors in "${entry.name}" output:
+
+` + utils_1.LlmJson.stringify(output),
+                        };
+                    return { success: true, data: output.data };
+                }
+                return { success: true, data: result };
             }
-            return { success: true, data: result };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: error instanceof Error
-                    ? `${error.name}: ${error.message}`
-                    : String(error),
-            };
-        }
-    }), {
-        name: entry.name,
-        description: (_a = entry.function.description) !== null && _a !== void 0 ? _a : "",
-        schema: entry.function.parameters,
-    }); };
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error
+                        ? `${error.name}: ${error.message}`
+                        : String(error),
+                };
+            }
+        }), {
+            name: entry.name,
+            description: (_a = entry.function.description) !== null && _a !== void 0 ? _a : "",
+            // Declares the model-facing schema without a validator, so the
+            // coerce-and-validate step above is the only one that runs; see
+            // `LangChainParameterConverter`. The cast is needed because `tool()`
+            // still types `schema` as Zod-or-JSON-Schema, even though the
+            // `toJsonSchema` it reads that schema back with accepts Standard JSON
+            // Schema by its own public signature.
+            schema: LangChainParameterConverter_1.LangChainParameterConverter.convert(entry.function),
+        });
+    };
+    const getToolName = (controllerName, functionName, prefix) => (prefix ? `${controllerName}_${functionName}` : functionName);
 })(LangChainToolsRegistrar || (exports.LangChainToolsRegistrar = LangChainToolsRegistrar = {}));
 //# sourceMappingURL=LangChainToolsRegistrar.js.map

package/lib/internal/LangChainToolsRegistrar.js.map

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

package/lib/internal/LangChainToolsRegistrar.mjs

@@ -1,3 +1,4 @@
+import { LangChainParameterConverter } from "./LangChainParameterConverter.mjs";
 import { ToolInputParsingException, tool } from "@langchain/core/tools";
 import { HttpLlm, LlmJson } from "@typia/utils";
 //#region src/internal/LangChainToolsRegistrar.ts
@@ -6,13 +7,15 @@ let LangChainToolsRegistrar;
 	_LangChainToolsRegistrar.convert = (props) => {
 		const prefix = props.prefix ?? false;
 		const tools = [];
-		if (prefix === false && props.controllers.length >= 2) {
+		if (props.controllers.length >= 2) {
 			const names = /* @__PURE__ */ 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 !== void 0) duplicates.push(`"${func.name}" in "${controller.name}" (conflicts with "${existing}")`);
-				else names.set(func.name, controller.name);
+				const toolName = getToolName(controller.name, func.name, prefix);
+				const existing = names.get(toolName);
+				const origin = `${controller.protocol} controller "${controller.name}" function "${func.name}"`;
+				if (existing !== void 0) duplicates.push(`"${toolName}" from ${origin} (conflicts with ${existing})`);
+				else names.set(toolName, origin);
 			}
 			if (duplicates.length > 0) throw new Error(`Duplicate tool names found:\n  - ${duplicates.join("\n  - ")}`);
 		}
@@ -23,12 +26,13 @@ let LangChainToolsRegistrar;
 	const convertClassController = (tools, controller, prefix) => {
 		const execute = controller.execute;
 		for (const func of controller.application.functions) {
-			const toolName = prefix ? `${controller.name}_${func.name}` : func.name;
+			const toolName = getToolName(controller.name, func.name, prefix);
 			const method = execute[func.name];
 			if (typeof method !== "function") throw new Error(`Method "${func.name}" not found on controller "${controller.name}"`);
 			tools.push(createTool({
 				name: toolName,
 				function: func,
+				config: controller.application.config,
 				execute: async (args) => method.call(execute, args)
 			}));
 		}
@@ -37,10 +41,11 @@ let LangChainToolsRegistrar;
 		const application = controller.application;
 		const connection = controller.connection;
 		for (const func of application.functions) {
-			const toolName = prefix ? `${controller.name}_${func.name}` : func.name;
+			const toolName = getToolName(controller.name, func.name, prefix);
 			tools.push(createTool({
 				name: toolName,
 				function: func,
+				config: application.config,
 				execute: async (args) => {
 					if (controller.execute !== void 0) return (await controller.execute({
 						connection,
@@ -58,30 +63,47 @@ let LangChainToolsRegistrar;
 			}));
 		}
 	};
-	const createTool = (entry) => tool(async (args) => {
-		const valid = LlmJson.validateArguments(entry.function, args ?? {});
-		if (valid.success === false) throw new ToolInputParsingException(`Type errors in "${entry.name}" arguments:\n\n\`\`\`json\n${LlmJson.stringify(valid)}\n\`\`\``, JSON.stringify(args ?? {}));
-		try {
-			const result = await entry.execute(valid.data);
-			if (result === void 0) return entry.function.output === void 0 ? { success: true } : {
-				success: false,
-				error: `Function "${entry.name}" returned undefined despite declaring an output schema`
-			};
-			return {
-				success: true,
-				data: result
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? `${error.name}: ${error.message}` : String(error)
-			};
-		}
-	}, {
-		name: entry.name,
-		description: entry.function.description ?? "",
-		schema: entry.function.parameters
-	});
+	const createTool = (entry) => {
+		const validateOutput = entry.function.output === void 0 ? void 0 : LlmJson.validate(entry.function.output, true, entry.config);
+		return tool(async (args) => {
+			const valid = LlmJson.validateArguments(entry.function, args ?? {});
+			if (valid.success === false) throw new ToolInputParsingException(`Type errors in "${entry.name}" arguments:\n\n` + LlmJson.stringify(valid), JSON.stringify(args ?? {}));
+			try {
+				const result = await entry.execute(valid.data);
+				if (result === void 0) return validateOutput === void 0 ? { success: true } : {
+					success: false,
+					error: `Function "${entry.name}" returned undefined despite declaring an output schema`
+				};
+				if (validateOutput !== void 0) {
+					const output = validateOutput(result);
+					if (output.success === false) return {
+						success: false,
+						error: `Type errors in "${entry.name}" output:
+
+` + LlmJson.stringify(output)
+					};
+					return {
+						success: true,
+						data: output.data
+					};
+				}
+				return {
+					success: true,
+					data: result
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: error instanceof Error ? `${error.name}: ${error.message}` : String(error)
+				};
+			}
+		}, {
+			name: entry.name,
+			description: entry.function.description ?? "",
+			schema: LangChainParameterConverter.convert(entry.function)
+		});
+	};
+	const getToolName = (controllerName, functionName, prefix) => prefix ? `${controllerName}_${functionName}` : functionName;
 })(LangChainToolsRegistrar || (LangChainToolsRegistrar = {}));
 //#endregion
 export { LangChainToolsRegistrar };

package/lib/internal/LangChainToolsRegistrar.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"LangChainToolsRegistrar.mjs","names":[],"sources":["../../src/internal/LangChainToolsRegistrar.ts"],"sourcesContent":["import {\n  DynamicStructuredTool,\n  ToolInputParsingException,\n  tool,\n} from \"@langchain/core/tools\";\nimport {\n  IHttpLlmController,\n  IHttpLlmFunction,\n  ILlmController,\n  ILlmFunction,\n  IValidation,\n} from \"@typia/interface\";\nimport { HttpLlm, LlmJson } from \"@typia/utils\";\n\nexport namespace LangChainToolsRegistrar {\n  export const convert = (props: {\n    controllers: Array<ILlmController | IHttpLlmController>;\n    prefix?: boolean | undefined;\n  }): DynamicStructuredTool[] => {\n    const prefix: boolean = props.prefix ?? false;\n    const tools: DynamicStructuredTool[] = [];\n\n    // check duplicate tool names\n    if (prefix === false && props.controllers.length >= 2) {\n      const names: Map<string, string> = new Map();\n      const duplicates: string[] = [];\n      for (const controller of props.controllers) {\n        for (const func of controller.application.functions) {\n          const existing: string | undefined = names.get(func.name);\n          if (existing !== undefined)\n            duplicates.push(\n              `\"${func.name}\" in \"${controller.name}\" (conflicts with \"${existing}\")`,\n            );\n          else names.set(func.name, controller.name);\n        }\n      }\n      if (duplicates.length > 0)\n        throw new Error(\n          `Duplicate tool names found:\\n  - ${duplicates.join(\"\\n  - \")}`,\n        );\n    }\n\n    // convert controllers to tools\n    for (const controller of props.controllers) {\n      if (controller.protocol === \"class\") {\n        convertClassController(tools, controller, prefix);\n      } else {\n        convertHttpController(tools, controller, prefix);\n      }\n    }\n\n    return tools;\n  };\n\n  const convertClassController = (\n    tools: DynamicStructuredTool[],\n    controller: ILlmController,\n    prefix: boolean,\n  ): void => {\n    const execute: Record<string, unknown> = controller.execute;\n\n    for (const func of controller.application.functions) {\n      const toolName: string = prefix\n        ? `${controller.name}_${func.name}`\n        : func.name;\n\n      const method: unknown = execute[func.name];\n      if (typeof method !== \"function\") {\n        throw new Error(\n          `Method \"${func.name}\" not found on controller \"${controller.name}\"`,\n        );\n      }\n\n      tools.push(\n        createTool({\n          name: toolName,\n          function: func,\n          execute: async (args: unknown) => method.call(execute, args),\n        }),\n      );\n    }\n  };\n\n  const convertHttpController = (\n    tools: DynamicStructuredTool[],\n    controller: IHttpLlmController,\n    prefix: boolean,\n  ): void => {\n    const application = controller.application;\n    const connection = controller.connection;\n\n    for (const func of application.functions) {\n      const toolName: string = prefix\n        ? `${controller.name}_${func.name}`\n        : func.name;\n\n      tools.push(\n        createTool({\n          name: toolName,\n          function: func,\n          execute: async (args: unknown) => {\n            if (controller.execute !== undefined) {\n              const response = await controller.execute({\n                connection,\n                application,\n                function: func,\n                arguments: args as object,\n              });\n              return response.body;\n            }\n            return HttpLlm.execute({\n              application,\n              function: func,\n              connection,\n              input: args as object,\n            });\n          },\n        }),\n      );\n    }\n  };\n\n  const createTool = (entry: {\n    name: string;\n    function: ILlmFunction | IHttpLlmFunction;\n    execute: (args: unknown) => Promise<unknown>;\n  }): DynamicStructuredTool =>\n    tool(\n      async (args: unknown): Promise<unknown> => {\n        const valid: IValidation<unknown> = LlmJson.validateArguments(\n          entry.function,\n          args ?? {},\n        );\n        if (valid.success === false)\n          throw new ToolInputParsingException(\n            `Type errors in \"${entry.name}\" arguments:\\n\\n` +\n              `\\`\\`\\`json\\n${LlmJson.stringify(valid)}\\n\\`\\`\\``,\n            JSON.stringify(args ?? {}),\n          );\n        try {\n          const result: unknown = await entry.execute(valid.data);\n          if (result === undefined) {\n            return entry.function.output === undefined\n              ? ({ success: true } satisfies ITryResult)\n              : ({\n                  success: false,\n                  error: `Function \"${entry.name}\" returned undefined despite declaring an output schema`,\n                } satisfies ITryResult);\n          }\n          return { success: true, data: result } satisfies ITryResult;\n        } catch (error) {\n          return {\n            success: false,\n            error:\n              error instanceof Error\n                ? `${error.name}: ${error.message}`\n                : String(error),\n          } satisfies ITryResult;\n        }\n      },\n      {\n        name: entry.name,\n        description: entry.function.description ?? \"\",\n        schema: entry.function.parameters,\n      },\n    );\n}\n\ntype ITryResult =\n  | { success: true; data?: unknown | undefined }\n  | { success: false; error: string };\n"],"mappings":";;;AAcO,IAAA;;qCACmB,UAGO;EAC7B,MAAM,SAAkB,MAAM,UAAU;EACxC,MAAM,QAAiC,CAAC;EAGxC,IAAI,WAAW,SAAS,MAAM,YAAY,UAAU,GAAG;GACrD,MAAM,wBAA6B,IAAI,IAAI;GAC3C,MAAM,aAAuB,CAAC;GAC9B,KAAK,MAAM,cAAc,MAAM,aAC7B,KAAK,MAAM,QAAQ,WAAW,YAAY,WAAW;IACnD,MAAM,WAA+B,MAAM,IAAI,KAAK,IAAI;IACxD,IAAI,aAAa,KAAA,GACf,WAAW,KACT,IAAI,KAAK,KAAK,QAAQ,WAAW,KAAK,qBAAqB,SAAS,GACtE;SACG,MAAM,IAAI,KAAK,MAAM,WAAW,IAAI;GAC3C;GAEF,IAAI,WAAW,SAAS,GACtB,MAAM,IAAI,MACR,oCAAoC,WAAW,KAAK,QAAQ,GAC9D;EACJ;EAGA,KAAK,MAAM,cAAc,MAAM,aAC7B,IAAI,WAAW,aAAa,SAC1B,uBAAuB,OAAO,YAAY,MAAM;OAEhD,sBAAsB,OAAO,YAAY,MAAM;EAInD,OAAO;CACT;CAEA,MAAM,0BACJ,OACA,YACA,WACS;EACT,MAAM,UAAmC,WAAW;EAEpD,KAAK,MAAM,QAAQ,WAAW,YAAY,WAAW;GACnD,MAAM,WAAmB,SACrB,GAAG,WAAW,KAAK,GAAG,KAAK,SAC3B,KAAK;GAET,MAAM,SAAkB,QAAQ,KAAK;GACrC,IAAI,OAAO,WAAW,YACpB,MAAM,IAAI,MACR,WAAW,KAAK,KAAK,6BAA6B,WAAW,KAAK,EACpE;GAGF,MAAM,KACJ,WAAW;IACT,MAAM;IACN,UAAU;IACV,SAAS,OAAO,SAAkB,OAAO,KAAK,SAAS,IAAI;GAC7D,CAAC,CACH;EACF;CACF;CAEA,MAAM,yBACJ,OACA,YACA,WACS;EACT,MAAM,cAAc,WAAW;EAC/B,MAAM,aAAa,WAAW;EAE9B,KAAK,MAAM,QAAQ,YAAY,WAAW;GACxC,MAAM,WAAmB,SACrB,GAAG,WAAW,KAAK,GAAG,KAAK,SAC3B,KAAK;GAET,MAAM,KACJ,WAAW;IACT,MAAM;IACN,UAAU;IACV,SAAS,OAAO,SAAkB;KAChC,IAAI,WAAW,YAAY,KAAA,GAOzB,QAAO,MANgB,WAAW,QAAQ;MACxC;MACA;MACA,UAAU;MACV,WAAW;KACb,CAAC,EAAA,CACe;KAElB,OAAO,QAAQ,QAAQ;MACrB;MACA,UAAU;MACV;MACA,OAAO;KACT,CAAC;IACH;GACF,CAAC,CACH;EACF;CACF;CAEA,MAAM,cAAc,UAKlB,KACE,OAAO,SAAoC;EACzC,MAAM,QAA8B,QAAQ,kBAC1C,MAAM,UACN,QAAQ,CAAC,CACX;EACA,IAAI,MAAM,YAAY,OACpB,MAAM,IAAI,0BACR,mBAAmB,MAAM,KAAK,8BACb,QAAQ,UAAU,KAAK,EAAE,WAC1C,KAAK,UAAU,QAAQ,CAAC,CAAC,CAC3B;EACF,IAAI;GACF,MAAM,SAAkB,MAAM,MAAM,QAAQ,MAAM,IAAI;GACtD,IAAI,WAAW,KAAA,GACb,OAAO,MAAM,SAAS,WAAW,KAAA,IAC5B,EAAE,SAAS,KAAK,IAChB;IACC,SAAS;IACT,OAAO,aAAa,MAAM,KAAK;GACjC;GAEN,OAAO;IAAE,SAAS;IAAM,MAAM;GAAO;EACvC,SAAS,OAAO;GACd,OAAO;IACL,SAAS;IACT,OACE,iBAAiB,QACb,GAAG,MAAM,KAAK,IAAI,MAAM,YACxB,OAAO,KAAK;GACpB;EACF;CACF,GACA;EACE,MAAM,MAAM;EACZ,aAAa,MAAM,SAAS,eAAe;EAC3C,QAAQ,MAAM,SAAS;CACzB,CACF;GACH,4BAAA,0BAAA,CAAA,EAAD"}
+{"version":3,"file":"LangChainToolsRegistrar.mjs","names":[],"sources":["../../src/internal/LangChainToolsRegistrar.ts"],"sourcesContent":["import {\n  DynamicStructuredTool,\n  ToolInputParsingException,\n  tool,\n} from \"@langchain/core/tools\";\nimport type { JSONSchema } from \"@langchain/core/utils/json_schema\";\nimport {\n  IHttpLlmController,\n  IHttpLlmFunction,\n  ILlmController,\n  ILlmFunction,\n  ILlmSchema,\n  IValidation,\n} from \"@typia/interface\";\nimport { HttpLlm, LlmJson } from \"@typia/utils\";\n\nimport { LangChainParameterConverter } from \"./LangChainParameterConverter\";\n\nexport namespace LangChainToolsRegistrar {\n  export const convert = (props: {\n    controllers: Array<ILlmController | IHttpLlmController>;\n    prefix?: boolean | undefined;\n  }): DynamicStructuredTool[] => {\n    const prefix: boolean = props.prefix ?? false;\n    const tools: DynamicStructuredTool[] = [];\n\n    // check duplicate tool names\n    if (props.controllers.length >= 2) {\n      const names: Map<string, string> = new Map();\n      const duplicates: string[] = [];\n      for (const controller of props.controllers) {\n        for (const func of controller.application.functions) {\n          const toolName: string = getToolName(\n            controller.name,\n            func.name,\n            prefix,\n          );\n          const existing: string | undefined = names.get(toolName);\n          const origin: string = `${controller.protocol} controller \"${controller.name}\" function \"${func.name}\"`;\n          if (existing !== undefined)\n            duplicates.push(\n              `\"${toolName}\" from ${origin} (conflicts with ${existing})`,\n            );\n          else names.set(toolName, origin);\n        }\n      }\n      if (duplicates.length > 0)\n        throw new Error(\n          `Duplicate tool names found:\\n  - ${duplicates.join(\"\\n  - \")}`,\n        );\n    }\n\n    // convert controllers to tools\n    for (const controller of props.controllers) {\n      if (controller.protocol === \"class\") {\n        convertClassController(tools, controller, prefix);\n      } else {\n        convertHttpController(tools, controller, prefix);\n      }\n    }\n\n    return tools;\n  };\n\n  const convertClassController = (\n    tools: DynamicStructuredTool[],\n    controller: ILlmController,\n    prefix: boolean,\n  ): void => {\n    const execute: Record<string, unknown> = controller.execute;\n\n    for (const func of controller.application.functions) {\n      const toolName: string = getToolName(controller.name, func.name, prefix);\n\n      const method: unknown = execute[func.name];\n      if (typeof method !== \"function\") {\n        throw new Error(\n          `Method \"${func.name}\" not found on controller \"${controller.name}\"`,\n        );\n      }\n\n      tools.push(\n        createTool({\n          name: toolName,\n          function: func,\n          config: controller.application.config,\n          execute: async (args: unknown) => method.call(execute, args),\n        }),\n      );\n    }\n  };\n\n  const convertHttpController = (\n    tools: DynamicStructuredTool[],\n    controller: IHttpLlmController,\n    prefix: boolean,\n  ): void => {\n    const application = controller.application;\n    const connection = controller.connection;\n\n    for (const func of application.functions) {\n      const toolName: string = getToolName(controller.name, func.name, prefix);\n\n      tools.push(\n        createTool({\n          name: toolName,\n          function: func,\n          config: application.config,\n          execute: async (args: unknown) => {\n            if (controller.execute !== undefined) {\n              const response = await controller.execute({\n                connection,\n                application,\n                function: func,\n                arguments: args as object,\n              });\n              return response.body;\n            }\n            return HttpLlm.execute({\n              application,\n              function: func,\n              connection,\n              input: args as object,\n            });\n          },\n        }),\n      );\n    }\n  };\n\n  const createTool = (entry: {\n    name: string;\n    function: ILlmFunction | IHttpLlmFunction;\n    config: ILlmSchema.IConfig;\n    execute: (args: unknown) => Promise<unknown>;\n  }): DynamicStructuredTool => {\n    // A declared return type is a promise to the model, so a result that breaks\n    // it is reported rather than delivered. `@typia/mcp` and `@typia/vercel`\n    // already refuse one; this tool consulted `output` for its existence alone,\n    // so a method returning nothing was reported while a method returning the\n    // wrong shape was not (#2302).\n    //\n    // The application's own config decides how the schema is read back: a\n    // strict application carries its constraints as description tags instead of\n    // keywords, and only that config tells the inverter to read them.\n    const validateOutput:\n      | ((output: unknown) => IValidation<unknown>)\n      | undefined =\n      entry.function.output === undefined\n        ? undefined\n        : LlmJson.validate(entry.function.output, true, entry.config);\n    return tool(\n      async (args: unknown): Promise<unknown> => {\n        const valid: IValidation<unknown> = LlmJson.validateArguments(\n          entry.function,\n          args ?? {},\n        );\n        if (valid.success === false)\n          throw new ToolInputParsingException(\n            `Type errors in \"${entry.name}\" arguments:\\n\\n` +\n              LlmJson.stringify(valid),\n            JSON.stringify(args ?? {}),\n          );\n        try {\n          const result: unknown = await entry.execute(valid.data);\n          if (result === undefined) {\n            return validateOutput === undefined\n              ? ({ success: true } satisfies ITryResult)\n              : ({\n                  success: false,\n                  error: `Function \"${entry.name}\" returned undefined despite declaring an output schema`,\n                } satisfies ITryResult);\n          }\n          if (validateOutput !== undefined) {\n            const output: IValidation<unknown> = validateOutput(result);\n            if (output.success === false)\n              return {\n                success: false,\n                error:\n                  `Type errors in \"${entry.name}\" output:\n\n` + LlmJson.stringify(output),\n              } satisfies ITryResult;\n            return { success: true, data: output.data } satisfies ITryResult;\n          }\n          return { success: true, data: result } satisfies ITryResult;\n        } catch (error) {\n          return {\n            success: false,\n            error:\n              error instanceof Error\n                ? `${error.name}: ${error.message}`\n                : String(error),\n          } satisfies ITryResult;\n        }\n      },\n      {\n        name: entry.name,\n        description: entry.function.description ?? \"\",\n        // Declares the model-facing schema without a validator, so the\n        // coerce-and-validate step above is the only one that runs; see\n        // `LangChainParameterConverter`. The cast is needed because `tool()`\n        // still types `schema` as Zod-or-JSON-Schema, even though the\n        // `toJsonSchema` it reads that schema back with accepts Standard JSON\n        // Schema by its own public signature.\n        schema: LangChainParameterConverter.convert(\n          entry.function,\n        ) as JSONSchema,\n      },\n    );\n  };\n\n  const getToolName = (\n    controllerName: string,\n    functionName: string,\n    prefix: boolean,\n  ): string => (prefix ? `${controllerName}_${functionName}` : functionName);\n}\n\ntype ITryResult =\n  | { success: true; data?: unknown | undefined }\n  | { success: false; error: string };\n"],"mappings":"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"}

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "@typia/langchain",
-  "version": "13.1.1",
+  "version": "13.2.0",
   "description": "LangChain.js integration for typia",
   "main": "lib/index.js",
   "exports": {
     ".": {
+      "import": {
+        "types": "./lib/index.d.mts",
+        "default": "./lib/index.mjs"
+      },
+      "require": {
+        "types": "./lib/index.d.cts",
+        "default": "./lib/index.js"
+      },
       "types": "./lib/index.d.ts",
-      "import": "./lib/index.mjs",
       "default": "./lib/index.js"
     },
     "./package.json": "./package.json"
@@ -22,18 +29,19 @@
   },
   "homepage": "https://typia.io",
   "dependencies": {
-    "@typia/utils": "^13.1.1",
-    "@typia/interface": "^13.1.1"
+    "@standard-schema/spec": "^1.1.0",
+    "@typia/interface": "^13.2.0",
+    "@typia/utils": "^13.2.0"
   },
   "peerDependencies": {
-    "@langchain/core": ">=1.0.0"
+    "@langchain/core": ">=1.1.30"
   },
   "devDependencies": {
     "@langchain/core": "^1.1.31",
     "rimraf": "^6.1.2",
     "rolldown": "^1.1.5",
     "tinyglobby": "^0.2.12",
-    "ttsc": "^0.18.4",
+    "ttsc": "^0.19.2",
     "typescript": "^7.0.2"
   },
   "sideEffects": false,
@@ -60,7 +68,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rimraf lib && ttsc && rolldown -c",
+    "build": "rimraf lib && ttsc && node ../../scripts/create-conditional-declarations.cjs lib/index.d.ts && rolldown -c",
     "dev": "ttsc --watch"
   },
   "module": "lib/index.mjs",

package/src/internal/LangChainParameterConverter.ts

@@ -0,0 +1,55 @@
+import { StandardJSONSchemaV1 } from "@standard-schema/spec";
+import { IHttpLlmFunction, ILlmFunction } from "@typia/interface";
+
+/**
+ * A Standard JSON Schema view of one typia function's parameters.
+ *
+ * LangChain's tool `schema` fills two roles at once:
+ * `toJsonSchema(tool.schema)` turns it into the parameters the model is shown,
+ * and `StructuredTool.call` validates incoming arguments against it before the
+ * tool body runs. Handing over a bare `ILlmSchema.IParameters` fills the first
+ * role but forfeits the second — LangChain validates it with
+ * `@cfworker/json-schema`, which rejects what typia would have coerced and
+ * reports the failure in its own words, so typia's coercion and its correctable
+ * feedback both become unreachable.
+ *
+ * Standard JSON Schema separates the two roles. It carries a model-facing
+ * schema under `~standard.jsonSchema` and, by declaring no
+ * `~standard.validate`, no validator — which is exactly typia's position: show
+ * the model this schema, and leave validation to `LlmJson.validateArguments` in
+ * the tool body. LangChain reads the schema back through its own
+ * `toJsonSchema`, so the model sees the same parameters document as before,
+ * byte for byte.
+ *
+ * `@typia/vercel` states the same contract to the AI SDK through
+ * `jsonSchema()`, whose `validate` is likewise left undefined so that
+ * `safeValidateTypes` short-circuits its own validation.
+ *
+ * Two version floors hold this together, and both are pinned in the package
+ * manifest. `toJsonSchema` only reads `~standard.jsonSchema` from
+ * `@langchain/core@1.1.30` onwards — older versions return the wrapper itself
+ * and would advertise _that_ to the model in place of the parameters — and
+ * `StandardJSONSchemaV1` only exists from `@standard-schema/spec@1.1.0`.
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ */
+export namespace LangChainParameterConverter {
+  export const convert = (
+    func: ILlmFunction | IHttpLlmFunction,
+  ): StandardJSONSchemaV1 => {
+    // Coercion never changes the shape a value must end up in, so the input and
+    // output schemas are the same document.
+    const jsonSchema = (): Record<string, unknown> =>
+      func.parameters as unknown as Record<string, unknown>;
+    return {
+      "~standard": {
+        version: 1,
+        vendor: "typia",
+        jsonSchema: {
+          input: jsonSchema,
+          output: jsonSchema,
+        },
+      },
+    };
+  };
+}

package/src/internal/LangChainToolsRegistrar.ts

@@ -3,15 +3,19 @@ import {
   ToolInputParsingException,
   tool,
 } from "@langchain/core/tools";
+import type { JSONSchema } from "@langchain/core/utils/json_schema";
 import {
   IHttpLlmController,
   IHttpLlmFunction,
   ILlmController,
   ILlmFunction,
+  ILlmSchema,
   IValidation,
 } from "@typia/interface";
 import { HttpLlm, LlmJson } from "@typia/utils";
 
+import { LangChainParameterConverter } from "./LangChainParameterConverter";
+
 export namespace LangChainToolsRegistrar {
   export const convert = (props: {
     controllers: Array<ILlmController | IHttpLlmController>;
@@ -21,17 +25,23 @@ export namespace LangChainToolsRegistrar {
     const tools: DynamicStructuredTool[] = [];
 
     // check duplicate tool names
-    if (prefix === false && props.controllers.length >= 2) {
+    if (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);
+          const toolName: string = getToolName(
+            controller.name,
+            func.name,
+            prefix,
+          );
+          const existing: string | undefined = names.get(toolName);
+          const origin: string = `${controller.protocol} controller "${controller.name}" function "${func.name}"`;
           if (existing !== undefined)
             duplicates.push(
-              `"${func.name}" in "${controller.name}" (conflicts with "${existing}")`,
+              `"${toolName}" from ${origin} (conflicts with ${existing})`,
             );
-          else names.set(func.name, controller.name);
+          else names.set(toolName, origin);
         }
       }
       if (duplicates.length > 0)
@@ -60,9 +70,7 @@ export namespace LangChainToolsRegistrar {
     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 toolName: string = getToolName(controller.name, func.name, prefix);
 
       const method: unknown = execute[func.name];
       if (typeof method !== "function") {
@@ -75,6 +83,7 @@ export namespace LangChainToolsRegistrar {
         createTool({
           name: toolName,
           function: func,
+          config: controller.application.config,
           execute: async (args: unknown) => method.call(execute, args),
         }),
       );
@@ -90,14 +99,13 @@ export namespace LangChainToolsRegistrar {
     const connection = controller.connection;
 
     for (const func of application.functions) {
-      const toolName: string = prefix
-        ? `${controller.name}_${func.name}`
-        : func.name;
+      const toolName: string = getToolName(controller.name, func.name, prefix);
 
       tools.push(
         createTool({
           name: toolName,
           function: func,
+          config: application.config,
           execute: async (args: unknown) => {
             if (controller.execute !== undefined) {
               const response = await controller.execute({
@@ -123,9 +131,25 @@ export namespace LangChainToolsRegistrar {
   const createTool = (entry: {
     name: string;
     function: ILlmFunction | IHttpLlmFunction;
+    config: ILlmSchema.IConfig;
     execute: (args: unknown) => Promise<unknown>;
-  }): DynamicStructuredTool =>
-    tool(
+  }): DynamicStructuredTool => {
+    // A declared return type is a promise to the model, so a result that breaks
+    // it is reported rather than delivered. `@typia/mcp` and `@typia/vercel`
+    // already refuse one; this tool consulted `output` for its existence alone,
+    // so a method returning nothing was reported while a method returning the
+    // wrong shape was not (#2302).
+    //
+    // The application's own config decides how the schema is read back: a
+    // strict application carries its constraints as description tags instead of
+    // keywords, and only that config tells the inverter to read them.
+    const validateOutput:
+      | ((output: unknown) => IValidation<unknown>)
+      | undefined =
+      entry.function.output === undefined
+        ? undefined
+        : LlmJson.validate(entry.function.output, true, entry.config);
+    return tool(
       async (args: unknown): Promise<unknown> => {
         const valid: IValidation<unknown> = LlmJson.validateArguments(
           entry.function,
@@ -134,19 +158,31 @@ export namespace LangChainToolsRegistrar {
         if (valid.success === false)
           throw new ToolInputParsingException(
             `Type errors in "${entry.name}" arguments:\n\n` +
-              `\`\`\`json\n${LlmJson.stringify(valid)}\n\`\`\``,
+              LlmJson.stringify(valid),
             JSON.stringify(args ?? {}),
           );
         try {
           const result: unknown = await entry.execute(valid.data);
           if (result === undefined) {
-            return entry.function.output === undefined
+            return validateOutput === undefined
               ? ({ success: true } satisfies ITryResult)
               : ({
                   success: false,
                   error: `Function "${entry.name}" returned undefined despite declaring an output schema`,
                 } satisfies ITryResult);
           }
+          if (validateOutput !== undefined) {
+            const output: IValidation<unknown> = validateOutput(result);
+            if (output.success === false)
+              return {
+                success: false,
+                error:
+                  `Type errors in "${entry.name}" output:
+
+` + LlmJson.stringify(output),
+              } satisfies ITryResult;
+            return { success: true, data: output.data } satisfies ITryResult;
+          }
           return { success: true, data: result } satisfies ITryResult;
         } catch (error) {
           return {
@@ -161,9 +197,24 @@ export namespace LangChainToolsRegistrar {
       {
         name: entry.name,
         description: entry.function.description ?? "",
-        schema: entry.function.parameters,
+        // Declares the model-facing schema without a validator, so the
+        // coerce-and-validate step above is the only one that runs; see
+        // `LangChainParameterConverter`. The cast is needed because `tool()`
+        // still types `schema` as Zod-or-JSON-Schema, even though the
+        // `toJsonSchema` it reads that schema back with accepts Standard JSON
+        // Schema by its own public signature.
+        schema: LangChainParameterConverter.convert(
+          entry.function,
+        ) as JSONSchema,
       },
     );
+  };
+
+  const getToolName = (
+    controllerName: string,
+    functionName: string,
+    prefix: boolean,
+  ): string => (prefix ? `${controllerName}_${functionName}` : functionName);
 }
 
 type ITryResult =