@typia/langchain 13.1.19 → 13.3.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

@@ -3,29 +3,31 @@ 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.
+ * 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.
+ * 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.
+ * `@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
+ * `@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

package/lib/internal/LangChainParameterConverter.js

@@ -4,29 +4,31 @@ 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.
+ * 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.
+ * 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.
+ * `@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
+ * `@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

package/lib/internal/LangChainParameterConverter.js.map

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

@@ -1 +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: `toJsonSchema(tool.schema)`\n * turns it into the parameters the model is shown, and `StructuredTool.call`\n * validates incoming arguments against it before the tool body runs. Handing\n * over a bare `ILlmSchema.IParameters` fills the first role but forfeits the\n * second — LangChain validates it with `@cfworker/json-schema`, which rejects\n * what typia would have coerced and reports the failure in its own words, so\n * typia's coercion and its correctable feedback both become unreachable.\n *\n * Standard JSON Schema separates the two roles. It carries a model-facing schema\n * under `~standard.jsonSchema` and, by declaring no `~standard.validate`, no\n * validator — which is exactly typia's position: show the model this schema, and\n * leave validation to `LlmJson.validateArguments` in the tool body. LangChain\n * reads the schema back through its own `toJsonSchema`, so the model sees the\n * same parameters document as before, byte for byte.\n *\n * `@typia/vercel` states the same contract to the AI SDK through `jsonSchema()`,\n * whose `validate` is likewise left undefined so that `safeValidateTypes`\n * 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 and\n * 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":";AAiCO,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"}
+{"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

@@ -59,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); }),
             }));
         }
@@ -71,6 +72,7 @@ var LangChainToolsRegistrar;
             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({
@@ -91,42 +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` +
-                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 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 : "",
-        // 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),
-    }); };
+            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

@@ -32,6 +32,7 @@ let LangChainToolsRegistrar;
 			tools.push(createTool({
 				name: toolName,
 				function: func,
+				config: controller.application.config,
 				execute: async (args) => method.call(execute, args)
 			}));
 		}
@@ -44,6 +45,7 @@ let LangChainToolsRegistrar;
 			tools.push(createTool({
 				name: toolName,
 				function: func,
+				config: application.config,
 				execute: async (args) => {
 					if (controller.execute !== void 0) return (await controller.execute({
 						connection,
@@ -61,30 +63,46 @@ 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` + LlmJson.stringify(valid), 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: LangChainParameterConverter.convert(entry.function)
-	});
+	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

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 type { JSONSchema } from \"@langchain/core/utils/json_schema\";\nimport {\n  IHttpLlmController,\n  IHttpLlmFunction,\n  ILlmController,\n  ILlmFunction,\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          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          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              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 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        // 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  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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"}
+{"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.19",
+  "version": "13.3.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"
@@ -23,8 +30,8 @@
   "homepage": "https://typia.io",
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@typia/interface": "^13.1.19",
-    "@typia/utils": "^13.1.19"
+    "@typia/interface": "^13.3.0",
+    "@typia/utils": "^13.3.0"
   },
   "peerDependencies": {
     "@langchain/core": ">=1.1.30"
@@ -61,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

@@ -4,29 +4,31 @@ 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.
+ * 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.
+ * 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.
+ * `@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
+ * `@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

package/src/internal/LangChainToolsRegistrar.ts

@@ -9,6 +9,7 @@ import {
   IHttpLlmFunction,
   ILlmController,
   ILlmFunction,
+  ILlmSchema,
   IValidation,
 } from "@typia/interface";
 import { HttpLlm, LlmJson } from "@typia/utils";
@@ -82,6 +83,7 @@ export namespace LangChainToolsRegistrar {
         createTool({
           name: toolName,
           function: func,
+          config: controller.application.config,
           execute: async (args: unknown) => method.call(execute, args),
         }),
       );
@@ -103,6 +105,7 @@ export namespace LangChainToolsRegistrar {
         createTool({
           name: toolName,
           function: func,
+          config: application.config,
           execute: async (args: unknown) => {
             if (controller.execute !== undefined) {
               const response = await controller.execute({
@@ -128,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,
@@ -145,13 +164,25 @@ export namespace LangChainToolsRegistrar {
         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 {
@@ -177,6 +208,7 @@ export namespace LangChainToolsRegistrar {
         ) as JSONSchema,
       },
     );
+  };
 
   const getToolName = (
     controllerName: string,