@typia/langchain 13.0.1-dev.20260703.1 → 13.0.1

package/LICENSE

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

package/README.md

@@ -1,114 +1,111 @@
-# `@typia/langchain`
-
-![Typia Logo](https://typia.io/logo.png)
-
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
-[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
-[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
-[![Build Status](https://github.com/samchon/typia/workflows/test/badge.svg)](https://github.com/samchon/typia/actions?query=workflow%3Atest)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://typia.io/docs/)
-[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/typia)
-[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
-
-[LangChain.js](https://github.com/langchain-ai/langchainjs) integration for [`typia`](https://github.com/samchon/typia).
-
-Converts typia controllers to LangChain `DynamicStructuredTool[]` with automatic validation.
-
-## Setup
-
-```bash
-npm install @typia/langchain @langchain/core typia
-npm install -D ttsc typescript@rc
-```
-
-## Usage
-
-### From TypeScript class
-
-```typescript
-import { ChainValues, Runnable } from "@langchain/core";
-import { ChatPromptTemplate } from "@langchain/core/prompts";
-import { DynamicStructuredTool } from "@langchain/core/tools";
-import { ChatOpenAI } from "@langchain/openai";
-import { toLangChainTools } from "@typia/langchain";
-import { AgentExecutor, createToolCallingAgent } from "langchain/agents";
-import typia from "typia";
-
-const tools: DynamicStructuredTool[] = toLangChainTools({
-  controllers: [
-    typia.llm.controller<Calculator>("Calculator", new Calculator()),
-  ],
-});
-
-const agent: Runnable = createToolCallingAgent({
-  llm: new ChatOpenAI({ model: "gpt-4o" }),
-  tools,
-  prompt: ChatPromptTemplate.fromMessages([
-    ["system", "You are a helpful assistant."],
-    ["human", "{input}"],
-    ["placeholder", "{agent_scratchpad}"],
-  ]),
-});
-const executor: AgentExecutor = new AgentExecutor({ agent, tools });
-const result: ChainValues = await executor.invoke({ input: "What is 10 + 5?" });
-```
-
-### From OpenAPI document
-
-```typescript
-import { DynamicStructuredTool } from "@langchain/core/tools";
-import { toLangChainTools } from "@typia/langchain";
-import { HttpLlm } from "@typia/utils";
-
-const tools: DynamicStructuredTool[] = toLangChainTools({
-  controllers: [
-    HttpLlm.controller({
-      name: "petStore",
-      document: yourOpenApiDocument,
-      connection: { host: "https://api.example.com" },
-    }),
-  ],
-});
-```
-
-### Structured Output
-
-Use `typia.llm.parameters<T>()` with LangChain's `withStructuredOutput()` to generate structured output with validation:
-
-```typescript
-import { ChatOpenAI } from "@langchain/openai";
-import { dedent, LlmJson } from "@typia/utils";
-import typia, { tags } from "typia";
-
-interface IMember {
-  email: string & tags.Format<"email">;
-  name: string;
-  age: number & tags.Minimum<0> & tags.Maximum<100>;
-  hobbies: string[];
-  joined_at: string & tags.Format<"date">;
-}
-
-const model = new ChatOpenAI({ model: "gpt-4o" }).withStructuredOutput(
-  typia.llm.parameters<IMember>(),
-);
-
-const member: IMember = await model.invoke(dedent`
-  I am a new member of the community.
-
-  My name is John Doe, and I am 25 years old.
-  I like playing basketball and reading books,
-  and joined to this community at 2022-01-01.
-`);
-
-// Validate the result
-const result = typia.validate<IMember>(member);
-if (!result.success) {
-  console.error(LlmJson.stringify(result));
-}
-```
-
-## Features
-
-- No manual schema definition — generates everything from TypeScript types or OpenAPI
-- Automatic argument validation with LLM-friendly error feedback
-- Supports both class-based (`typia.llm.controller`) and HTTP-based (`HttpLlm.controller`) controllers
+# `@typia/langchain`
+
+![Typia Logo](https://typia.io/logo.png)
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
+[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
+[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
+[![Build Status](https://github.com/samchon/typia/workflows/test/badge.svg)](https://github.com/samchon/typia/actions?query=workflow%3Atest)
+[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://typia.io/docs/)
+[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/typia)
+[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
+
+[LangChain.js](https://github.com/langchain-ai/langchainjs) integration for [`typia`](https://github.com/samchon/typia).
+
+Converts typia controllers to LangChain `DynamicStructuredTool[]` with automatic validation.
+
+## Setup
+
+```bash
+npm install @typia/langchain @langchain/core typia
+npm install -D ttsc typescript@rc
+```
+
+## Usage
+
+### From TypeScript class
+
+```typescript
+import { ChainValues, Runnable } from "@langchain/core";
+import { ChatPromptTemplate } from "@langchain/core/prompts";
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { ChatOpenAI } from "@langchain/openai";
+import { toLangChainTools } from "@typia/langchain";
+import { AgentExecutor, createToolCallingAgent } from "langchain/agents";
+import typia from "typia";
+
+const tools: DynamicStructuredTool[] = toLangChainTools(
+  typia.llm.controller<Calculator>("Calculator", new Calculator()),
+);
+
+const agent: Runnable = createToolCallingAgent({
+  llm: new ChatOpenAI({ model: "gpt-4o" }),
+  tools,
+  prompt: ChatPromptTemplate.fromMessages([
+    ["system", "You are a helpful assistant."],
+    ["human", "{input}"],
+    ["placeholder", "{agent_scratchpad}"],
+  ]),
+});
+const executor: AgentExecutor = new AgentExecutor({ agent, tools });
+const result: ChainValues = await executor.invoke({ input: "What is 10 + 5?" });
+```
+
+### From OpenAPI document
+
+```typescript
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { toLangChainTools } from "@typia/langchain";
+import { HttpLlm } from "@typia/utils";
+
+const tools: DynamicStructuredTool[] = toLangChainTools(
+  HttpLlm.controller({
+    name: "petStore",
+    document: yourOpenApiDocument,
+    connection: { host: "https://api.example.com" },
+  }),
+);
+```
+
+### Structured Output
+
+Use `typia.llm.parameters<T>()` with LangChain's `withStructuredOutput()` to generate structured output with validation:
+
+```typescript
+import { ChatOpenAI } from "@langchain/openai";
+import { dedent, LlmJson } from "@typia/utils";
+import typia, { tags } from "typia";
+
+interface IMember {
+  email: string & tags.Format<"email">;
+  name: string;
+  age: number & tags.Minimum<0> & tags.Maximum<100>;
+  hobbies: string[];
+  joined_at: string & tags.Format<"date">;
+}
+
+const model = new ChatOpenAI({ model: "gpt-4o" }).withStructuredOutput(
+  typia.llm.parameters<IMember>(),
+);
+
+const member: IMember = await model.invoke(dedent`
+  I am a new member of the community.
+
+  My name is John Doe, and I am 25 years old.
+  I like playing basketball and reading books,
+  and joined to this community at 2022-01-01.
+`);
+
+// Validate the result
+const result = typia.validate<IMember>(member);
+if (!result.success) {
+  console.error(LlmJson.stringify(result));
+}
+```
+
+## Features
+
+- No manual schema definition — generates everything from TypeScript types or OpenAPI
+- Automatic argument validation with LLM-friendly error feedback
+- Runtime tool errors are returned as `{ success: false, error }` for model recovery
+- Supports both class-based (`typia.llm.controller`) and HTTP-based (`HttpLlm.controller`) controllers

package/lib/index.d.ts

@@ -1,5 +1,28 @@
 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.
  *
@@ -22,37 +45,22 @@ import { IHttpLlmController, ILlmController } from "@typia/interface";
  *     }
  *   }
  *
- *   const tools = toLangChainTools({
- *     controllers: [
- *       typia.llm.controller<Calculator>("calculator", new Calculator()),
- *     ],
- *   });
+ *   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 props Conversion properties
+ * @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(props: {
-    /**
-     * 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: Array<ILlmController | IHttpLlmController>;
-    /**
-     * 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;
-}): 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.js

@@ -2,43 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toLangChainTools = toLangChainTools;
 const LangChainToolsRegistrar_1 = require("./internal/LangChainToolsRegistrar");
-/**
- * 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 tools = toLangChainTools({
- *     controllers: [
- *       typia.llm.controller<Calculator>("calculator", new Calculator()),
- *     ],
- *   });
- *
- *   const llm = await initChatModel();
- *   const modelWithTools = llm.bindTools(tools);
- *   const result = await modelWithTools.invoke("What is 10 + 5?");
- *   ```;
- *
- * @param props Conversion properties
- * @returns Array of LangChain DynamicStructuredTool
- */
-function toLangChainTools(props) {
-    return LangChainToolsRegistrar_1.LangChainToolsRegistrar.convert(props);
+function toLangChainTools(input, options) {
+    return LangChainToolsRegistrar_1.LangChainToolsRegistrar.convert(normalizeLangChainToolsProps(input, options));
 }
+const normalizeLangChainToolsProps = (input, options) => {
+    if (isLangChainToolsProps(input))
+        return input;
+    return {
+        controllers: Array.isArray(input) ? input : [input],
+        prefix: options === null || options === void 0 ? void 0 : options.prefix,
+    };
+};
+const isLangChainToolsProps = (input) => Array.isArray(input) === false &&
+    typeof input === "object" &&
+    input !== null &&
+    "controllers" in input;
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAGA,gFAA6E;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,0BAAiC,KAoBhC;IACC,OAAO,iDAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAGA,gFAA6E;AA4E7E,0BACE,KAA2E,EAC3E,OAA4C;IAE5C,OAAO,iDAAuB,CAAC,OAAO,CACpC,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,4BAA4B,GAAG,CACnC,KAA2E,EAC3E,OAA4C,EACtB,EAAE;IACxB,IAAI,qBAAqB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnD,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC5B,KAA2E,EAC5C,EAAE,CACjC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK;IAC9B,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,aAAa,IAAI,KAAK,CAAC"}

package/lib/index.mjs

@@ -1,3 +1,17 @@
-export { toLangChainTools } from './index2.mjs';
-export { __exports as default } from './_virtual/index.mjs';
-//# sourceMappingURL=index.mjs.map
+import { LangChainToolsRegistrar } from "./internal/LangChainToolsRegistrar.mjs";
+//#region src/index.ts
+function toLangChainTools(input, options) {
+	return LangChainToolsRegistrar.convert(normalizeLangChainToolsProps(input, options));
+}
+const normalizeLangChainToolsProps = (input, options) => {
+	if (isLangChainToolsProps(input)) return input;
+	return {
+		controllers: Array.isArray(input) ? input : [input],
+		prefix: options?.prefix
+	};
+};
+const isLangChainToolsProps = (input) => Array.isArray(input) === false && typeof input === "object" && input !== null && "controllers" in input;
+//#endregion
+export { toLangChainTools };
+
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { DynamicStructuredTool } from \"@langchain/core/tools\";\nimport { IHttpLlmController, ILlmController } from \"@typia/interface\";\n\nimport { LangChainToolsRegistrar } from \"./internal/LangChainToolsRegistrar\";\n\ntype ILangChainController = ILlmController | IHttpLlmController;\n\ninterface ILangChainToolsOptions {\n  /**\n   * Whether to add controller name as prefix to tool names.\n   *\n   * If `true`, tool names become `{controllerName}_{methodName}`. If `false`,\n   * tool names are just `{methodName}`.\n   *\n   * @default false\n   */\n  prefix?: boolean | undefined;\n}\n\ninterface ILangChainToolsProps extends ILangChainToolsOptions {\n  /**\n   * List of controllers to convert to LangChain tools.\n   *\n   * - {@link ILlmController}: from `typia.llm.controller<Class>()`, converts all\n   *   methods of the class to tools\n   * - {@link IHttpLlmController}: from `HttpLlm.controller()`, converts all\n   *   operations from OpenAPI document to tools\n   */\n  controllers: ILangChainController[];\n}\n\n/**\n * Convert typia controllers to LangChain tools.\n *\n * Converts TypeScript class methods via `typia.llm.controller<Class>()` or\n * OpenAPI operations via `HttpLlm.controller()` to LangChain tools.\n *\n * Every tool call is validated by typia. If LLM provides invalid arguments,\n * returns validation error formatted by {@link LlmJson.stringify} so that LLM\n * can correct them automatically.\n *\n * @example\n *   ```typescript\n *   import { initChatModel } from \"langchain/chat_models/universal\";\n *   import typia from \"typia\";\n *   import { toLangChainTools } from \"@typia/langchain\";\n *\n *   class Calculator {\n *     add(input: { a: number; b: number }): { value: number } {\n *       return { value: input.a + input.b };\n *     }\n *   }\n *\n *   const controller = typia.llm.controller<Calculator>(\n *     \"calculator\",\n *     new Calculator(),\n *   );\n *   const tools = toLangChainTools(controller);\n *\n *   const llm = await initChatModel();\n *   const modelWithTools = llm.bindTools(tools);\n *   const result = await modelWithTools.invoke(\"What is 10 + 5?\");\n *   ```;\n *\n * @param input Controller, controller list, or conversion properties\n * @param options Conversion options when `input` is not a properties object\n * @returns Array of LangChain DynamicStructuredTool\n */\nexport function toLangChainTools(\n  controller: ILangChainController,\n  options?: ILangChainToolsOptions | undefined,\n): DynamicStructuredTool[];\nexport function toLangChainTools(\n  controllers: ILangChainController[],\n  options?: ILangChainToolsOptions | undefined,\n): DynamicStructuredTool[];\nexport function toLangChainTools(\n  props: ILangChainToolsProps,\n): DynamicStructuredTool[];\nexport function toLangChainTools(\n  input: ILangChainController | ILangChainController[] | ILangChainToolsProps,\n  options?: ILangChainToolsOptions | undefined,\n): DynamicStructuredTool[] {\n  return LangChainToolsRegistrar.convert(\n    normalizeLangChainToolsProps(input, options),\n  );\n}\n\nconst normalizeLangChainToolsProps = (\n  input: ILangChainController | ILangChainController[] | ILangChainToolsProps,\n  options?: ILangChainToolsOptions | undefined,\n): ILangChainToolsProps => {\n  if (isLangChainToolsProps(input)) return input;\n  return {\n    controllers: Array.isArray(input) ? input : [input],\n    prefix: options?.prefix,\n  };\n};\n\nconst isLangChainToolsProps = (\n  input: ILangChainController | ILangChainController[] | ILangChainToolsProps,\n): input is ILangChainToolsProps =>\n  Array.isArray(input) === false &&\n  typeof input === \"object\" &&\n  input !== null &&\n  \"controllers\" in input;\n"],"mappings":";;AA+EA,SAAgB,iBACd,OACA,SACyB;CACzB,OAAO,wBAAwB,QAC7B,6BAA6B,OAAO,OAAO,CAC7C;AACF;AAEA,MAAM,gCACJ,OACA,YACyB;CACzB,IAAI,sBAAsB,KAAK,GAAG,OAAO;CACzC,OAAO;EACL,aAAa,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;EAClD,QAAQ,SAAS;CACnB;AACF;AAEA,MAAM,yBACJ,UAEA,MAAM,QAAQ,KAAK,MAAM,SACzB,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB"}

package/lib/internal/LangChainToolsRegistrar.js

@@ -92,21 +92,35 @@ var LangChainToolsRegistrar;
             }));
         }
     };
-    const createTool = (entry) => { var _a; return new tools_1.DynamicStructuredTool({
+    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`,
+                    };
+            }
+            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,
-        func: (args) => __awaiter(this, void 0, void 0, function* () {
-            const coerced = utils_1.LlmJson.coerce(args, entry.function.parameters);
-            const valid = entry.function.validate(coerced);
-            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(coerced));
-            const result = yield entry.execute(valid.data);
-            return result === undefined
-                ? { success: true }
-                : { success: true, data: result };
-        }),
     }); };
 })(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,89 @@
-export { LangChainToolsRegistrar } from './LangChainToolsRegistrar2.mjs';
-export { __exports as default } from '../_virtual/LangChainToolsRegistrar.mjs';
-//# sourceMappingURL=LangChainToolsRegistrar.mjs.map
+import { ToolInputParsingException, tool } from "@langchain/core/tools";
+import { HttpLlm, LlmJson } from "@typia/utils";
+//#region src/internal/LangChainToolsRegistrar.ts
+let LangChainToolsRegistrar;
+(function(_LangChainToolsRegistrar) {
+	_LangChainToolsRegistrar.convert = (props) => {
+		const prefix = props.prefix ?? false;
+		const tools = [];
+		if (prefix === false && 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);
+			}
+			if (duplicates.length > 0) throw new Error(`Duplicate tool names found:\n  - ${duplicates.join("\n  - ")}`);
+		}
+		for (const controller of props.controllers) if (controller.protocol === "class") convertClassController(tools, controller, prefix);
+		else convertHttpController(tools, controller, prefix);
+		return tools;
+	};
+	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 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,
+				execute: async (args) => method.call(execute, args)
+			}));
+		}
+	};
+	const convertHttpController = (tools, controller, prefix) => {
+		const application = controller.application;
+		const connection = controller.connection;
+		for (const func of application.functions) {
+			const toolName = prefix ? `${controller.name}_${func.name}` : func.name;
+			tools.push(createTool({
+				name: toolName,
+				function: func,
+				execute: async (args) => {
+					if (controller.execute !== void 0) return (await controller.execute({
+						connection,
+						application,
+						function: func,
+						arguments: args
+					})).body;
+					return HttpLlm.execute({
+						application,
+						function: func,
+						connection,
+						input: args
+					});
+				}
+			}));
+		}
+	};
+	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
+	});
+})(LangChainToolsRegistrar || (LangChainToolsRegistrar = {}));
+//#endregion
+export { LangChainToolsRegistrar };
+
+//# sourceMappingURL=LangChainToolsRegistrar.mjs.map

package/lib/internal/LangChainToolsRegistrar.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"LangChainToolsRegistrar.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typia/langchain",
-  "version": "13.0.1-dev.20260703.1",
+  "version": "13.0.1",
   "description": "LangChain.js integration for typia",
   "main": "lib/index.js",
   "exports": {
@@ -22,23 +22,19 @@
   },
   "homepage": "https://typia.io",
   "dependencies": {
-    "@typia/interface": "^13.0.1-dev.20260703.1",
-    "@typia/utils": "^13.0.1-dev.20260703.1"
+    "@typia/interface": "^13.0.1",
+    "@typia/utils": "^13.0.1"
   },
   "peerDependencies": {
     "@langchain/core": ">=1.0.0"
   },
   "devDependencies": {
     "@langchain/core": "^1.1.31",
-    "@rollup/plugin-commonjs": "^29.0.0",
-    "@rollup/plugin-esm-shim": "^0.1.8",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "typescript": "7.0.1-rc",
     "rimraf": "^6.1.2",
-    "rollup": "^4.56.0",
-    "rollup-plugin-node-externals": "^8.1.2",
+    "rolldown": "^1.1.5",
     "tinyglobby": "^0.2.12",
-    "ttsc": "^0.16.7"
+    "ttsc": "^0.17.3",
+    "typescript": "^7.0.2"
   },
   "sideEffects": false,
   "files": [
@@ -64,7 +60,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rimraf lib && ttsc && rollup -c",
+    "build": "rimraf lib && ttsc && rolldown -c",
     "dev": "ttsc --watch"
   },
   "module": "lib/index.mjs",

package/src/index.ts

@@ -3,6 +3,32 @@ import { IHttpLlmController, ILlmController } from "@typia/interface";
 
 import { LangChainToolsRegistrar } from "./internal/LangChainToolsRegistrar";
 
+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.
  *
@@ -25,40 +51,56 @@ import { LangChainToolsRegistrar } from "./internal/LangChainToolsRegistrar";
  *     }
  *   }
  *
- *   const tools = toLangChainTools({
- *     controllers: [
- *       typia.llm.controller<Calculator>("calculator", new Calculator()),
- *     ],
- *   });
+ *   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 props Conversion properties
+ * @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 function toLangChainTools(props: {
-  /**
-   * 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: Array<ILlmController | IHttpLlmController>;
-
-  /**
-   * 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;
-}): DynamicStructuredTool[] {
-  return LangChainToolsRegistrar.convert(props);
+export function toLangChainTools(
+  controller: ILangChainController,
+  options?: ILangChainToolsOptions | undefined,
+): DynamicStructuredTool[];
+export function toLangChainTools(
+  controllers: ILangChainController[],
+  options?: ILangChainToolsOptions | undefined,
+): DynamicStructuredTool[];
+export function toLangChainTools(
+  props: ILangChainToolsProps,
+): DynamicStructuredTool[];
+export function toLangChainTools(
+  input: ILangChainController | ILangChainController[] | ILangChainToolsProps,
+  options?: ILangChainToolsOptions | undefined,
+): DynamicStructuredTool[] {
+  return LangChainToolsRegistrar.convert(
+    normalizeLangChainToolsProps(input, options),
+  );
 }
+
+const normalizeLangChainToolsProps = (
+  input: ILangChainController | ILangChainController[] | ILangChainToolsProps,
+  options?: ILangChainToolsOptions | undefined,
+): ILangChainToolsProps => {
+  if (isLangChainToolsProps(input)) return input;
+  return {
+    controllers: Array.isArray(input) ? input : [input],
+    prefix: options?.prefix,
+  };
+};
+
+const isLangChainToolsProps = (
+  input: ILangChainController | ILangChainController[] | ILangChainToolsProps,
+): input is ILangChainToolsProps =>
+  Array.isArray(input) === false &&
+  typeof input === "object" &&
+  input !== null &&
+  "controllers" in input;

package/src/internal/LangChainToolsRegistrar.ts

@@ -1,6 +1,7 @@
 import {
   DynamicStructuredTool,
   ToolInputParsingException,
+  tool,
 } from "@langchain/core/tools";
 import {
   IHttpLlmController,
@@ -124,26 +125,47 @@ export namespace LangChainToolsRegistrar {
     function: ILlmFunction | IHttpLlmFunction;
     execute: (args: unknown) => Promise<unknown>;
   }): DynamicStructuredTool =>
-    new DynamicStructuredTool<any>({
-      name: entry.name,
-      description: entry.function.description ?? "",
-      schema: entry.function.parameters,
-      func: async (args: unknown): Promise<unknown> => {
-        const coerced: unknown = LlmJson.coerce(
-          args,
-          entry.function.parameters,
+    tool(
+      async (args: unknown): Promise<unknown> => {
+        const valid: IValidation<unknown> = LlmJson.validateArguments(
+          entry.function,
+          args ?? {},
         );
-        const valid: IValidation<unknown> = entry.function.validate(coerced);
         if (valid.success === false)
           throw new ToolInputParsingException(
             `Type errors in "${entry.name}" arguments:\n\n` +
               `\`\`\`json\n${LlmJson.stringify(valid)}\n\`\`\``,
-            JSON.stringify(coerced),
+            JSON.stringify(args ?? {}),
           );
-        const result: unknown = await entry.execute(valid.data);
-        return result === undefined
-          ? { success: true }
-          : { success: true, data: result };
+        try {
+          const result: unknown = await entry.execute(valid.data);
+          if (result === undefined) {
+            return entry.function.output === undefined
+              ? ({ success: true } satisfies ITryResult)
+              : ({
+                  success: false,
+                  error: `Function "${entry.name}" returned undefined despite declaring an output schema`,
+                } satisfies ITryResult);
+          }
+          return { success: true, data: result } satisfies ITryResult;
+        } catch (error) {
+          return {
+            success: false,
+            error:
+              error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : String(error),
+          } satisfies ITryResult;
+        }
+      },
+      {
+        name: entry.name,
+        description: entry.function.description ?? "",
+        schema: entry.function.parameters,
       },
-    });
+    );
 }
+
+type ITryResult =
+  | { success: true; data?: unknown | undefined }
+  | { success: false; error: string };

package/lib/_virtual/LangChainToolsRegistrar.mjs

@@ -1,4 +0,0 @@
-var LangChainToolsRegistrar = {};
-
-export { LangChainToolsRegistrar as __exports };
-//# sourceMappingURL=LangChainToolsRegistrar.mjs.map

package/lib/_virtual/LangChainToolsRegistrar.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"LangChainToolsRegistrar.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/lib/_virtual/_commonjsHelpers.mjs

@@ -1,31 +0,0 @@
-function getAugmentedNamespace(n) {
-  if (Object.prototype.hasOwnProperty.call(n, '__esModule')) return n;
-  var f = n.default;
-	if (typeof f == "function") {
-		var a = function a () {
-			var isInstance = false;
-      try {
-        isInstance = this instanceof a;
-      } catch {}
-			if (isInstance) {
-        return Reflect.construct(f, arguments, this.constructor);
-			}
-			return f.apply(this, arguments);
-		};
-		a.prototype = f.prototype;
-  } else a = {};
-  Object.defineProperty(a, '__esModule', {value: true});
-	Object.keys(n).forEach(function (k) {
-		var d = Object.getOwnPropertyDescriptor(n, k);
-		Object.defineProperty(a, k, d.get ? d : {
-			enumerable: true,
-			get: function () {
-				return n[k];
-			}
-		});
-	});
-	return a;
-}
-
-export { getAugmentedNamespace };
-//# sourceMappingURL=_commonjsHelpers.mjs.map

package/lib/_virtual/_commonjsHelpers.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"_commonjsHelpers.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/_virtual/index.mjs

@@ -1,4 +0,0 @@
-var lib = {};
-
-export { lib as __exports };
-//# sourceMappingURL=index.mjs.map

package/lib/_virtual/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/lib/_virtual/tools.mjs

@@ -1,7 +0,0 @@
-import * as tools from '@langchain/core/tools';
-import { getAugmentedNamespace } from './_commonjsHelpers.mjs';
-
-var require$$0 = /*@__PURE__*/getAugmentedNamespace(tools);
-
-export { require$$0 as default };
-//# sourceMappingURL=tools.mjs.map

package/lib/_virtual/tools.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/lib/index2.mjs

@@ -1,49 +0,0 @@
-import { __exports as lib } from './_virtual/index.mjs';
-import './internal/LangChainToolsRegistrar2.mjs';
-import { __exports as LangChainToolsRegistrar } from './_virtual/LangChainToolsRegistrar.mjs';
-
-Object.defineProperty(lib, "__esModule", { value: true });
-var toLangChainTools_1 = lib.toLangChainTools = toLangChainTools;
-const LangChainToolsRegistrar_1 = LangChainToolsRegistrar;
-/**
- * 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 tools = toLangChainTools({
- *     controllers: [
- *       typia.llm.controller<Calculator>("calculator", new Calculator()),
- *     ],
- *   });
- *
- *   const llm = await initChatModel();
- *   const modelWithTools = llm.bindTools(tools);
- *   const result = await modelWithTools.invoke("What is 10 + 5?");
- *   ```;
- *
- * @param props Conversion properties
- * @returns Array of LangChain DynamicStructuredTool
- */
-function toLangChainTools(props) {
-    return LangChainToolsRegistrar_1.LangChainToolsRegistrar.convert(props);
-}
-
-export { lib as default, toLangChainTools_1 as toLangChainTools };
-//# sourceMappingURL=index2.mjs.map

package/lib/index2.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index2.mjs","sources":["index.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.toLangChainTools = toLangChainTools;\nconst LangChainToolsRegistrar_1 = require(\"./internal/LangChainToolsRegistrar\");\n/**\n * Convert typia controllers to LangChain tools.\n *\n * Converts TypeScript class methods via `typia.llm.controller<Class>()` or\n * OpenAPI operations via `HttpLlm.controller()` to LangChain tools.\n *\n * Every tool call is validated by typia. If LLM provides invalid arguments,\n * returns validation error formatted by {@link LlmJson.stringify} so that LLM\n * can correct them automatically.\n *\n * @example\n *   ```typescript\n *   import { initChatModel } from \"langchain/chat_models/universal\";\n *   import typia from \"typia\";\n *   import { toLangChainTools } from \"@typia/langchain\";\n *\n *   class Calculator {\n *     add(input: { a: number; b: number }): { value: number } {\n *       return { value: input.a + input.b };\n *     }\n *   }\n *\n *   const tools = toLangChainTools({\n *     controllers: [\n *       typia.llm.controller<Calculator>(\"calculator\", new Calculator()),\n *     ],\n *   });\n *\n *   const llm = await initChatModel();\n *   const modelWithTools = llm.bindTools(tools);\n *   const result = await modelWithTools.invoke(\"What is 10 + 5?\");\n *   ```;\n *\n * @param props Conversion properties\n * @returns Array of LangChain DynamicStructuredTool\n */\nfunction toLangChainTools(props) {\n    return LangChainToolsRegistrar_1.LangChainToolsRegistrar.convert(props);\n}\n//# sourceMappingURL=index.js.map"],"names":["require$$0"],"mappings":";;;;AACA,MAAM,CAAC,cAAc,CAAC,GAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,kBAAA,GAAA,GAAA,CAAA,gBAAwB,GAAG;AAC3B,MAAM,yBAAyB,GAAGA,uBAA6C;AAC/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,gBAAgB,CAAC,KAAK,EAAE;AACjC,IAAI,OAAO,yBAAyB,CAAC,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC;AAC3E;;;;"}

package/lib/internal/LangChainToolsRegistrar2.mjs

@@ -1,117 +0,0 @@
-import { __exports as LangChainToolsRegistrar$1 } from '../_virtual/LangChainToolsRegistrar.mjs';
-import require$$0 from '../_virtual/tools.mjs';
-import require$$1 from '@typia/utils';
-
-var __awaiter = (LangChainToolsRegistrar$1 && LangChainToolsRegistrar$1.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(LangChainToolsRegistrar$1, "__esModule", { value: true });
-var LangChainToolsRegistrar_2 = LangChainToolsRegistrar$1.LangChainToolsRegistrar = void 0;
-const tools_1 = require$$0;
-const utils_1 = require$$1;
-var LangChainToolsRegistrar;
-(function (LangChainToolsRegistrar) {
-    LangChainToolsRegistrar.convert = (props) => {
-        var _a;
-        const prefix = (_a = props.prefix) !== null && _a !== void 0 ? _a : false;
-        const tools = [];
-        // check duplicate tool names
-        if (prefix === false && props.controllers.length >= 2) {
-            const names = new Map();
-            const duplicates = [];
-            for (const controller of props.controllers) {
-                for (const func of controller.application.functions) {
-                    const existing = names.get(func.name);
-                    if (existing !== undefined)
-                        duplicates.push(`"${func.name}" in "${controller.name}" (conflicts with "${existing}")`);
-                    else
-                        names.set(func.name, controller.name);
-                }
-            }
-            if (duplicates.length > 0)
-                throw new Error(`Duplicate tool names found:\n  - ${duplicates.join("\n  - ")}`);
-        }
-        // convert controllers to tools
-        for (const controller of props.controllers) {
-            if (controller.protocol === "class") {
-                convertClassController(tools, controller, prefix);
-            }
-            else {
-                convertHttpController(tools, controller, prefix);
-            }
-        }
-        return tools;
-    };
-    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 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,
-                execute: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(execute, args); }),
-            }));
-        }
-    };
-    const convertHttpController = (tools, controller, prefix) => {
-        const application = controller.application;
-        const connection = controller.connection;
-        for (const func of application.functions) {
-            const toolName = prefix
-                ? `${controller.name}_${func.name}`
-                : func.name;
-            tools.push(createTool({
-                name: toolName,
-                function: func,
-                execute: (args) => __awaiter(this, void 0, void 0, function* () {
-                    if (controller.execute !== undefined) {
-                        const response = yield controller.execute({
-                            connection,
-                            application,
-                            function: func,
-                            arguments: args,
-                        });
-                        return response.body;
-                    }
-                    return utils_1.HttpLlm.execute({
-                        application,
-                        function: func,
-                        connection,
-                        input: args,
-                    });
-                }),
-            }));
-        }
-    };
-    const createTool = (entry) => { var _a; return new tools_1.DynamicStructuredTool({
-        name: entry.name,
-        description: (_a = entry.function.description) !== null && _a !== void 0 ? _a : "",
-        schema: entry.function.parameters,
-        func: (args) => __awaiter(this, void 0, void 0, function* () {
-            const coerced = utils_1.LlmJson.coerce(args, entry.function.parameters);
-            const valid = entry.function.validate(coerced);
-            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(coerced));
-            const result = yield entry.execute(valid.data);
-            return result === undefined
-                ? { success: true }
-                : { success: true, data: result };
-        }),
-    }); };
-})(LangChainToolsRegistrar || (LangChainToolsRegistrar_2 = LangChainToolsRegistrar$1.LangChainToolsRegistrar = LangChainToolsRegistrar = {}));
-
-export { LangChainToolsRegistrar_2 as LangChainToolsRegistrar, LangChainToolsRegistrar$1 as default };
-//# sourceMappingURL=LangChainToolsRegistrar2.mjs.map

package/lib/internal/LangChainToolsRegistrar2.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"LangChainToolsRegistrar2.mjs","sources":["LangChainToolsRegistrar.js"],"sourcesContent":["\"use strict\";\nvar __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n    return new (P || (P = Promise))(function (resolve, reject) {\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\n    });\n};\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.LangChainToolsRegistrar = void 0;\nconst tools_1 = require(\"@langchain/core/tools\");\nconst utils_1 = require(\"@typia/utils\");\nvar LangChainToolsRegistrar;\n(function (LangChainToolsRegistrar) {\n    LangChainToolsRegistrar.convert = (props) => {\n        var _a;\n        const prefix = (_a = props.prefix) !== null && _a !== void 0 ? _a : false;\n        const tools = [];\n        // check duplicate tool names\n        if (prefix === false && props.controllers.length >= 2) {\n            const names = new Map();\n            const duplicates = [];\n            for (const controller of props.controllers) {\n                for (const func of controller.application.functions) {\n                    const existing = names.get(func.name);\n                    if (existing !== undefined)\n                        duplicates.push(`\"${func.name}\" in \"${controller.name}\" (conflicts with \"${existing}\")`);\n                    else\n                        names.set(func.name, controller.name);\n                }\n            }\n            if (duplicates.length > 0)\n                throw new Error(`Duplicate tool names found:\\n  - ${duplicates.join(\"\\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            }\n            else {\n                convertHttpController(tools, controller, prefix);\n            }\n        }\n        return tools;\n    };\n    const convertClassController = (tools, controller, prefix) => {\n        const execute = controller.execute;\n        for (const func of controller.application.functions) {\n            const toolName = prefix\n                ? `${controller.name}_${func.name}`\n                : func.name;\n            const method = execute[func.name];\n            if (typeof method !== \"function\") {\n                throw new Error(`Method \"${func.name}\" not found on controller \"${controller.name}\"`);\n            }\n            tools.push(createTool({\n                name: toolName,\n                function: func,\n                execute: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(execute, args); }),\n            }));\n        }\n    };\n    const convertHttpController = (tools, controller, prefix) => {\n        const application = controller.application;\n        const connection = controller.connection;\n        for (const func of application.functions) {\n            const toolName = prefix\n                ? `${controller.name}_${func.name}`\n                : func.name;\n            tools.push(createTool({\n                name: toolName,\n                function: func,\n                execute: (args) => __awaiter(this, void 0, void 0, function* () {\n                    if (controller.execute !== undefined) {\n                        const response = yield controller.execute({\n                            connection,\n                            application,\n                            function: func,\n                            arguments: args,\n                        });\n                        return response.body;\n                    }\n                    return utils_1.HttpLlm.execute({\n                        application,\n                        function: func,\n                        connection,\n                        input: args,\n                    });\n                }),\n            }));\n        }\n    };\n    const createTool = (entry) => { var _a; return new tools_1.DynamicStructuredTool({\n        name: entry.name,\n        description: (_a = entry.function.description) !== null && _a !== void 0 ? _a : \"\",\n        schema: entry.function.parameters,\n        func: (args) => __awaiter(this, void 0, void 0, function* () {\n            const coerced = utils_1.LlmJson.coerce(args, entry.function.parameters);\n            const valid = entry.function.validate(coerced);\n            if (valid.success === false)\n                throw new tools_1.ToolInputParsingException(`Type errors in \"${entry.name}\" arguments:\\n\\n` +\n                    `\\`\\`\\`json\\n${utils_1.LlmJson.stringify(valid)}\\n\\`\\`\\``, JSON.stringify(coerced));\n            const result = yield entry.execute(valid.data);\n            return result === undefined\n                ? { success: true }\n                : { success: true, data: result };\n        }),\n    }); };\n})(LangChainToolsRegistrar || (exports.LangChainToolsRegistrar = LangChainToolsRegistrar = {}));\n//# sourceMappingURL=LangChainToolsRegistrar.js.map"],"names":["this","LangChainToolsRegistrar_1"],"mappings":";;;;AACA,IAAI,SAAS,GAAG,CAACA,yBAAI,IAAIA,yBAAI,CAAC,SAAS,KAAK,UAAU,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE;AACzF,IAAI,SAAS,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,KAAK,YAAY,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA,CAAE,CAAC,CAAC,CAAA;AAC9G,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,EAAE,UAAU,OAAO,EAAE,MAAM,EAAE;AAC/D,QAAQ,SAAS,SAAS,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA,CAAE,CAAA;AACjG,QAAQ,SAAS,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA,CAAE,CAAA;AACpG,QAAQ,SAAS,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAA;AACpH,QAAQ,IAAI,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AAC7E,IAAA,CAAK,CAAC;AACN,CAAC;AACD,MAAM,CAAC,cAAc,CAACC,yBAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,yBAAA,GAAAA,yBAAA,CAAA,uBAA+B,GAAG;AAClC,MAAM,OAAO,GAAG,UAAgC;AAChD,MAAM,OAAO,GAAG,UAAuB;AACvC,IAAI,uBAAuB;AAC3B,CAAC,UAAU,uBAAuB,EAAE;AACpC,IAAI,uBAAuB,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK;AACjD,QAAQ,IAAI,EAAE;AACd,QAAQ,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,KAAK;AACjF,QAAQ,MAAM,KAAK,GAAG,EAAE;AACxB;AACA,QAAQ,IAAI,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE;AAC/D,YAAY,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE;AACnC,YAAY,MAAM,UAAU,GAAG,EAAE;AACjC,YAAY,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE;AACxD,gBAAgB,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE;AACrE,oBAAoB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AACzD,oBAAoB,IAAI,QAAQ,KAAK,SAAS;AAC9C,wBAAwB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChH;AACA,wBAAwB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;AAC7D,gBAAA;AACA,YAAA;AACA,YAAY,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;AACrC,gBAAgB,MAAM,IAAI,KAAK,CAAC,CAAC,iCAAiC,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAChG,QAAA;AACA;AACA,QAAQ,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE;AACpD,YAAY,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE;AACjD,gBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC;AACjE,YAAA;AACA,iBAAiB;AACjB,gBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC;AAChE,YAAA;AACA,QAAA;AACA,QAAQ,OAAO,KAAK;AACpB,IAAA,CAAK;AACL,IAAI,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK;AAClE,QAAQ,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO;AAC1C,QAAQ,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE;AAC7D,YAAY,MAAM,QAAQ,GAAG;AAC7B,kBAAkB,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;AAClD,kBAAkB,IAAI,CAAC,IAAI;AAC3B,YAAY,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;AAC7C,YAAY,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE;AAC9C,gBAAgB,MAAM,IAAI,KAAK,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,2BAA2B,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrG,YAAA;AACA,YAAY,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;AAClC,gBAAgB,IAAI,EAAE,QAAQ;AAC9B,gBAAgB,QAAQ,EAAE,IAAI;AAC9B,gBAAgB,OAAO,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA,CAAE,CAAC;AACvH,aAAa,CAAC,CAAC;AACf,QAAA;AACA,IAAA,CAAK;AACL,IAAI,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK;AACjE,QAAQ,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW;AAClD,QAAQ,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU;AAChD,QAAQ,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,EAAE;AAClD,YAAY,MAAM,QAAQ,GAAG;AAC7B,kBAAkB,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;AAClD,kBAAkB,IAAI,CAAC,IAAI;AAC3B,YAAY,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;AAClC,gBAAgB,IAAI,EAAE,QAAQ;AAC9B,gBAAgB,QAAQ,EAAE,IAAI;AAC9B,gBAAgB,OAAO,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;AAChF,oBAAoB,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE;AAC1D,wBAAwB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;AAClE,4BAA4B,UAAU;AACtC,4BAA4B,WAAW;AACvC,4BAA4B,QAAQ,EAAE,IAAI;AAC1C,4BAA4B,SAAS,EAAE,IAAI;AAC3C,yBAAyB,CAAC;AAC1B,wBAAwB,OAAO,QAAQ,CAAC,IAAI;AAC5C,oBAAA;AACA,oBAAoB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;AACnD,wBAAwB,WAAW;AACnC,wBAAwB,QAAQ,EAAE,IAAI;AACtC,wBAAwB,UAAU;AAClC,wBAAwB,KAAK,EAAE,IAAI;AACnC,qBAAqB,CAAC;AACtB,gBAAA,CAAiB,CAAC;AAClB,aAAa,CAAC,CAAC;AACf,QAAA;AACA,IAAA,CAAK;AACL,IAAI,MAAM,UAAU,GAAG,CAAC,KAAK,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC;AACrF,QAAQ,IAAI,EAAE,KAAK,CAAC,IAAI;AACxB,QAAQ,WAAW,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,EAAE;AAC1F,QAAQ,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;AACzC,QAAQ,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;AACrE,YAAY,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;AACnF,YAAY,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;AAC1D,YAAY,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK;AACvC,gBAAgB,MAAM,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;AAC3G,oBAAoB,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACvG,YAAY,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;AAC1D,YAAY,OAAO,MAAM,KAAK;AAC9B,kBAAkB,EAAE,OAAO,EAAE,IAAI;AACjC,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;AACjD,QAAA,CAAS,CAAC;AACV,KAAK,CAAC,CAAC,CAAA,CAAE;AACT,CAAC,EAAE,uBAAuB,KAAK,yBAAA,GAAAA,yBAAA,CAAA,uBAA+B,GAAG,uBAAuB,GAAG,EAAE,CAAC,CAAC;;;;"}