typia 12.0.0-dev.20260307 → 12.0.0-dev.20260309

package/lib/internal/_coerceLlmArguments.d.ts

@@ -0,0 +1,2 @@
+import { ILlmSchema } from "@typia/interface";
+export declare const _coerceLlmArguments: <T>(value: unknown, parameters: ILlmSchema.IParameters) => T;

package/lib/internal/_coerceLlmArguments.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._coerceLlmArguments = void 0;
+const utils_1 = require("@typia/utils");
+const _coerceLlmArguments = (value, parameters) => utils_1.LlmJson.coerce(value, parameters);
+exports._coerceLlmArguments = _coerceLlmArguments;
+//# sourceMappingURL=_coerceLlmArguments.js.map

package/lib/internal/_coerceLlmArguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_coerceLlmArguments.js","sourceRoot":"","sources":["../../src/internal/_coerceLlmArguments.ts"],"names":[],"mappings":";;;AACA,wCAAuC;AAEhC,MAAM,mBAAmB,GAAG,CACjC,KAAc,EACd,UAAkC,EAC/B,EAAE,CAAC,eAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAH7B,QAAA,mBAAmB,uBAGU"}

package/lib/internal/_coerceLlmArguments.mjs

@@ -0,0 +1,6 @@
+import { LlmJson } from '@typia/utils';
+
+const _coerceLlmArguments = (value, parameters) => LlmJson.coerce(value, parameters);
+
+export { _coerceLlmArguments };
+//# sourceMappingURL=_coerceLlmArguments.mjs.map

package/lib/internal/_coerceLlmArguments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_coerceLlmArguments.mjs","sources":["../../src/internal/_coerceLlmArguments.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGO,MAAM,mBAAmB,GAAG,CACjC,KAAc,EACd,UAAkC,KAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU;;;;"}

package/lib/internal/_llmApplicationFinalize.js

@@ -6,7 +6,7 @@ const _llmApplicationFinalize = (app, config) => {
     var _a;
     return (Object.assign(Object.assign({}, app), { config: Object.assign(Object.assign({}, utils_1.LlmSchemaConverter.getConfig()), { validate: (_a = config === null || config === void 0 ? void 0 : config.validate) !== null && _a !== void 0 ? _a : null }), functions: app.functions.map((func) => {
             var _a, _b;
-            return (Object.assign(Object.assign({}, func), { parse: (input) => utils_1.LlmJson.parse(input, func.parameters), validate: (_b = (_a = config === null || config === void 0 ? void 0 : config.validate) === null || _a === void 0 ? void 0 : _a[func.name]) !== null && _b !== void 0 ? _b : func.validate }));
+            return (Object.assign(Object.assign({}, func), { parse: (input) => utils_1.LlmJson.parse(input, func.parameters), coerce: (input) => utils_1.LlmJson.coerce(input, func.parameters), validate: (_b = (_a = config === null || config === void 0 ? void 0 : config.validate) === null || _a === void 0 ? void 0 : _a[func.name]) !== null && _b !== void 0 ? _b : func.validate }));
         }) }));
 };
 exports._llmApplicationFinalize = _llmApplicationFinalize;

package/lib/internal/_llmApplicationFinalize.js.map

@@ -1 +1 @@
-{"version":3,"file":"_llmApplicationFinalize.js","sourceRoot":"","sources":["../../src/internal/_llmApplicationFinalize.ts"],"names":[],"mappings":";;;AACA,wCAA2D;AAEpD,MAAM,uBAAuB,GAAG,CACrC,GAAwC,EACxC,MAIC,EACuB,EAAE;;IAAC,OAAA,iCACxB,GAAG,KACN,MAAM,kCACD,0BAAkB,CAAC,SAAS,EAAE,KACjC,QAAQ,EAAE,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,mCAAI,IAAI,KAEpC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;;YAAC,OAAA,iCAClC,IAAI,KACP,KAAK,EAAE,CAAC,KAAa,EAA6B,EAAE,CAClD,eAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EACvC,QAAQ,EAAE,MAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,0CAAG,IAAI,CAAC,IAAI,CAAC,mCAAI,IAAI,CAAC,QAAQ,IACxD,CAAA;SAAA,CAAC,IACH,CAAA;CAAA,CAAC;AAnBU,QAAA,uBAAuB,2BAmBjC"}
+{"version":3,"file":"_llmApplicationFinalize.js","sourceRoot":"","sources":["../../src/internal/_llmApplicationFinalize.ts"],"names":[],"mappings":";;;AACA,wCAA2D;AAEpD,MAAM,uBAAuB,GAAG,CACrC,GAAwC,EACxC,MAIC,EACuB,EAAE;;IAAC,OAAA,iCACxB,GAAG,KACN,MAAM,kCACD,0BAAkB,CAAC,SAAS,EAAE,KACjC,QAAQ,EAAE,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,mCAAI,IAAI,KAEpC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;;YAAC,OAAA,iCAClC,IAAI,KACP,KAAK,EAAE,CAAC,KAAa,EAA6B,EAAE,CAClD,eAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EACvC,MAAM,EAAE,CAAC,KAAc,EAAW,EAAE,CAAC,eAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAC3E,QAAQ,EAAE,MAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,0CAAG,IAAI,CAAC,IAAI,CAAC,mCAAI,IAAI,CAAC,QAAQ,IACxD,CAAA;SAAA,CAAC,IACH,CAAA;CAAA,CAAC;AApBU,QAAA,uBAAuB,2BAoBjC"}

package/lib/internal/_llmApplicationFinalize.mjs

@@ -9,6 +9,7 @@ const _llmApplicationFinalize = (app, config) => ({
     functions: app.functions.map((func) => ({
         ...func,
         parse: (input) => LlmJson.parse(input, func.parameters),
+        coerce: (input) => LlmJson.coerce(input, func.parameters),
         validate: config?.validate?.[func.name] ?? func.validate,
     })),
 });

package/lib/internal/_llmApplicationFinalize.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_llmApplicationFinalize.mjs","sources":["../../src/internal/_llmApplicationFinalize.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGO,MAAM,uBAAuB,GAAG,CACrC,GAAwC,EACxC,MAIC,MAC2B;AAC5B,IAAA,GAAG,GAAG;AACN,IAAA,MAAM,EAAE;QACN,GAAG,kBAAkB,CAAC,SAAS,EAAE;AACjC,QAAA,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI;AACnC,KAAA;AACD,IAAA,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM;AACtC,QAAA,GAAG,IAAI;AACP,QAAA,KAAK,EAAE,CAAC,KAAa,KACnB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;AACvC,QAAA,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;AACzD,KAAA,CAAC,CAAC;AACJ,CAAA;;;;"}
+{"version":3,"file":"_llmApplicationFinalize.mjs","sources":["../../src/internal/_llmApplicationFinalize.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGO,MAAM,uBAAuB,GAAG,CACrC,GAAwC,EACxC,MAIC,MAC2B;AAC5B,IAAA,GAAG,GAAG;AACN,IAAA,MAAM,EAAE;QACN,GAAG,kBAAkB,CAAC,SAAS,EAAE;AACjC,QAAA,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI;AACnC,KAAA;AACD,IAAA,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM;AACtC,QAAA,GAAG,IAAI;AACP,QAAA,KAAK,EAAE,CAAC,KAAa,KACnB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;AACvC,QAAA,MAAM,EAAE,CAAC,KAAc,KAAc,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;AAC3E,QAAA,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;AACzD,KAAA,CAAC,CAAC;AACJ,CAAA;;;;"}

package/lib/internal/_parseLlmArguments.d.ts

@@ -0,0 +1,2 @@
+import { IJsonParseResult, ILlmSchema } from "@typia/interface";
+export declare const _parseLlmArguments: <T>(input: string, parameters: ILlmSchema.IParameters) => IJsonParseResult<T>;

package/lib/internal/_parseLlmArguments.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._parseLlmArguments = void 0;
+const utils_1 = require("@typia/utils");
+const _parseLlmArguments = (input, parameters) => utils_1.LlmJson.parse(input, parameters);
+exports._parseLlmArguments = _parseLlmArguments;
+//# sourceMappingURL=_parseLlmArguments.js.map

package/lib/internal/_parseLlmArguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_parseLlmArguments.js","sourceRoot":"","sources":["../../src/internal/_parseLlmArguments.ts"],"names":[],"mappings":";;;AACA,wCAAuC;AAEhC,MAAM,kBAAkB,GAAG,CAChC,KAAa,EACb,UAAkC,EACb,EAAE,CAAC,eAAO,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAH9C,QAAA,kBAAkB,sBAG4B"}

package/lib/internal/_parseLlmArguments.mjs

@@ -0,0 +1,6 @@
+import { LlmJson } from '@typia/utils';
+
+const _parseLlmArguments = (input, parameters) => LlmJson.parse(input, parameters);
+
+export { _parseLlmArguments };
+//# sourceMappingURL=_parseLlmArguments.mjs.map

package/lib/internal/_parseLlmArguments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_parseLlmArguments.mjs","sources":["../../src/internal/_parseLlmArguments.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGO,MAAM,kBAAkB,GAAG,CAChC,KAAa,EACb,UAAkC,KACV,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU;;;;"}

package/lib/llm.d.ts

@@ -1,4 +1,4 @@
-import { ILlmApplication, ILlmController, ILlmSchema } from "@typia/interface";
+import { IJsonParseResult, ILlmApplication, ILlmController, ILlmSchema } from "@typia/interface";
 /**
  * Creates LLM function calling controller.
  *
@@ -152,3 +152,156 @@ export declare function schema(): never;
  * @returns LLM type schema
  */
 export declare function schema<T, Config extends Partial<ILlmSchema.IConfig> = {}>($defs: Record<string, ILlmSchema>): ILlmSchema;
+/**
+ * Parse LLM response JSON with type coercion.
+ *
+ * @danger You must configure the generic argument `Parameters`
+ */
+export declare function parse(input: string): never;
+/**
+ * Parse lenient JSON with schema-based type coercion.
+ *
+ * Handles incomplete or malformed JSON commonly produced by LLMs:
+ *
+ * - Unclosed brackets, strings, trailing commas
+ * - JavaScript-style comments (`//` and multi-line)
+ * - Unquoted object keys, incomplete keywords (`tru`, `fal`, `nul`)
+ * - Markdown code block extraction, junk prefix skipping
+ *
+ * Also coerces double-stringified values based on the `Parameters` schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * For repeated parsing, use {@link createParse} to avoid regenerating the schema
+ * each time.
+ *
+ * Related functions:
+ *
+ * - {@link createParse} — Create reusable parser function
+ * - {@link coerce} — Type coercion for already-parsed objects
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @param input Raw JSON string (potentially incomplete or malformed)
+ * @returns Parse result with typed data on success, or partial data with errors
+ */
+export declare function parse<Parameters extends Record<string, any>, Config extends Partial<ILlmSchema.IConfig> = {}>(input: string): IJsonParseResult<Parameters>;
+/**
+ * Coerce LLM arguments to match expected schema types.
+ *
+ * LLMs often return values with incorrect types (e.g., numbers as strings).
+ * This function recursively coerces values based on the `Parameters` schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Use this when your SDK provides already-parsed objects but values may have
+ * wrong types. For raw JSON strings, use {@link parse} instead.
+ *
+ * For repeated coercion, use {@link createCoerce} to avoid regenerating the
+ * schema each time.
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * Related functions:
+ *
+ * - {@link createCoerce} — Create reusable coercer function
+ * - {@link parse} — Parse and coerce raw JSON strings
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @param input Parsed arguments object from LLM (with potentially wrong types)
+ * @returns Coerced arguments with corrected types
+ */
+export declare function coerce<Parameters extends Record<string, any>, Config extends Partial<ILlmSchema.IConfig> = {}>(input: Parameters): Parameters;
+/**
+ * Create reusable LLM JSON parser with type coercion.
+ *
+ * @danger You must configure the generic argument `Parameters`
+ */
+export declare function createParse(): never;
+/**
+ * Create reusable lenient JSON parser with schema-based type coercion.
+ *
+ * Returns a parser function that handles incomplete or malformed JSON commonly
+ * produced by LLMs:
+ *
+ * - Unclosed brackets, strings, trailing commas
+ * - JavaScript-style comments (`//` and multi-line)
+ * - Unquoted object keys, incomplete keywords (`tru`, `fal`, `nul`)
+ * - Markdown code block extraction, junk prefix skipping
+ *
+ * Also coerces double-stringified values based on the `Parameters` schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Use this instead of {@link parse} when parsing multiple inputs to avoid
+ * regenerating the schema each time.
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * Related functions:
+ *
+ * - {@link parse} — One-shot parsing (regenerates schema each call)
+ * - {@link createCoerce} — Create reusable coercer function
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @returns Reusable parser function
+ */
+export declare function createParse<Parameters extends Record<string, any>, Config extends Partial<ILlmSchema.IConfig> = {}>(): (input: string) => IJsonParseResult<Parameters>;
+/**
+ * Create reusable LLM arguments coercer.
+ *
+ * @danger You must configure the generic argument `Parameters`
+ */
+export declare function createCoerce(): never;
+/**
+ * Create reusable coercer for LLM arguments.
+ *
+ * Returns a coercer function that fixes incorrect types commonly returned by
+ * LLMs (e.g., numbers as strings). Coerces values based on the `Parameters`
+ * schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Use this instead of {@link coerce} when coercing multiple inputs to avoid
+ * regenerating the schema each time.
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * Related functions:
+ *
+ * - {@link coerce} — One-shot coercion (regenerates schema each call)
+ * - {@link createParse} — Create reusable parser function
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @returns Reusable coercer function
+ */
+export declare function createCoerce<Parameters extends Record<string, any>, Config extends Partial<ILlmSchema.IConfig> = {}>(): (input: Parameters) => Parameters;

package/lib/llm.js

@@ -4,6 +4,10 @@ exports.controller = controller;
 exports.application = application;
 exports.parameters = parameters;
 exports.schema = schema;
+exports.parse = parse;
+exports.coerce = coerce;
+exports.createParse = createParse;
+exports.createCoerce = createCoerce;
 const NoTransformConfigurationError_1 = require("./transformers/NoTransformConfigurationError");
 /** @internal */
 function controller(..._args) {
@@ -21,4 +25,20 @@ function parameters() {
 function schema() {
     (0, NoTransformConfigurationError_1.NoTransformConfigurationError)("llm.schema");
 }
+/** @internal */
+function parse() {
+    (0, NoTransformConfigurationError_1.NoTransformConfigurationError)("llm.parse");
+}
+/** @internal */
+function coerce() {
+    (0, NoTransformConfigurationError_1.NoTransformConfigurationError)("llm.coerce");
+}
+/** @internal */
+function createParse() {
+    (0, NoTransformConfigurationError_1.NoTransformConfigurationError)("llm.createParse");
+}
+/** @internal */
+function createCoerce() {
+    (0, NoTransformConfigurationError_1.NoTransformConfigurationError)("llm.createCoerce");
+}
 //# sourceMappingURL=llm.js.map

package/lib/llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":";;AAmEA,gCAEC;AA2DD,kCAEC;AAqCD,gCAEC;AAuCD,wBAEC;AAhND,gGAA6F;AAgE7F,gBAAgB;AAChB,SAAgB,UAAU,CAAC,GAAG,KAAY;IACxC,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AA0DD,gBAAgB;AAChB,SAAgB,WAAW;IACzB,IAAA,6DAA6B,EAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAoCD,gBAAgB;AAChB,SAAgB,UAAU;IACxB,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAsCD,gBAAgB;AAChB,SAAgB,MAAM;IACpB,IAAA,6DAA6B,EAAC,YAAY,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":";;AAwEA,gCAEC;AA2DD,kCAEC;AAqCD,gCAEC;AAuCD,wBAEC;AAkDD,sBAEC;AAwCD,wBAEC;AAkDD,kCAEC;AA4CD,oCAEC;AAhZD,gGAA6F;AAgE7F,gBAAgB;AAChB,SAAgB,UAAU,CAAC,GAAG,KAAY;IACxC,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AA0DD,gBAAgB;AAChB,SAAgB,WAAW;IACzB,IAAA,6DAA6B,EAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAoCD,gBAAgB;AAChB,SAAgB,UAAU;IACxB,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAsCD,gBAAgB;AAChB,SAAgB,MAAM;IACpB,IAAA,6DAA6B,EAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAiDD,gBAAgB;AAChB,SAAgB,KAAK;IACnB,IAAA,6DAA6B,EAAC,WAAW,CAAC,CAAC;AAC7C,CAAC;AAuCD,gBAAgB;AAChB,SAAgB,MAAM;IACpB,IAAA,6DAA6B,EAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAiDD,gBAAgB;AAChB,SAAgB,WAAW;IACzB,IAAA,6DAA6B,EAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC;AA2CD,gBAAgB;AAChB,SAAgB,YAAY;IAC1B,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC"}

package/lib/llm.mjs

@@ -16,6 +16,22 @@ function parameters() {
 function schema() {
     NoTransformConfigurationError("llm.schema");
 }
+/** @internal */
+function parse() {
+    NoTransformConfigurationError("llm.parse");
+}
+/** @internal */
+function coerce() {
+    NoTransformConfigurationError("llm.coerce");
+}
+/** @internal */
+function createParse() {
+    NoTransformConfigurationError("llm.createParse");
+}
+/** @internal */
+function createCoerce() {
+    NoTransformConfigurationError("llm.createCoerce");
+}
 
-export { application, controller, parameters, schema };
+export { application, coerce, controller, createCoerce, createParse, parameters, parse, schema };
 //# sourceMappingURL=llm.mjs.map

package/lib/llm.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"llm.mjs","sources":["../src/llm.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAkEA;AACM,SAAU,UAAU,CAAC,GAAG,KAAY,EAAA;IACxC,6BAA6B,CAAC,gBAAgB,CAAC;AACjD;AA0DA;SACgB,WAAW,GAAA;IACzB,6BAA6B,CAAC,iBAAiB,CAAC;AAClD;AAoCA;SACgB,UAAU,GAAA;IACxB,6BAA6B,CAAC,gBAAgB,CAAC;AACjD;AAsCA;SACgB,MAAM,GAAA;IACpB,6BAA6B,CAAC,YAAY,CAAC;AAC7C;;;;"}
+{"version":3,"file":"llm.mjs","sources":["../src/llm.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAuEA;AACM,SAAU,UAAU,CAAC,GAAG,KAAY,EAAA;IACxC,6BAA6B,CAAC,gBAAgB,CAAC;AACjD;AA0DA;SACgB,WAAW,GAAA;IACzB,6BAA6B,CAAC,iBAAiB,CAAC;AAClD;AAoCA;SACgB,UAAU,GAAA;IACxB,6BAA6B,CAAC,gBAAgB,CAAC;AACjD;AAsCA;SACgB,MAAM,GAAA;IACpB,6BAA6B,CAAC,YAAY,CAAC;AAC7C;AAiDA;SACgB,KAAK,GAAA;IACnB,6BAA6B,CAAC,WAAW,CAAC;AAC5C;AAuCA;SACgB,MAAM,GAAA;IACpB,6BAA6B,CAAC,YAAY,CAAC;AAC7C;AAiDA;SACgB,WAAW,GAAA;IACzB,6BAA6B,CAAC,iBAAiB,CAAC;AAClD;AA2CA;SACgB,YAAY,GAAA;IAC1B,6BAA6B,CAAC,kBAAkB,CAAC;AACnD;;;;"}

package/lib/re-exports.d.ts

@@ -1 +1 @@
-export { AssertionGuard, IValidation, IRandomGenerator, OpenApi, IJsonSchemaCollection, IJsonSchemaUnit, ILlmController, ILlmApplication, ILlmFunction, ILlmSchema, IMetadataSchema, IMetadataSchemaCollection, IMetadataSchemaUnit, IMetadataComponents, IMetadataTypeTag, IJsDocTagInfo, Primitive, Resolved, CamelCase, PascalCase, SnakeCase, IReadableURLSearchParams, tags, } from "@typia/interface";
+export { AssertionGuard, IJsonParseResult, IValidation, IRandomGenerator, OpenApi, IJsonSchemaCollection, IJsonSchemaUnit, ILlmController, ILlmApplication, ILlmFunction, ILlmSchema, IMetadataSchema, IMetadataSchemaCollection, IMetadataSchemaUnit, IMetadataComponents, IMetadataTypeTag, IJsDocTagInfo, Primitive, Resolved, CamelCase, PascalCase, SnakeCase, IReadableURLSearchParams, tags, } from "@typia/interface";

package/lib/re-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"re-exports.js","sourceRoot":"","sources":["../src/re-exports.ts"],"names":[],"mappings":";;;AAAA,8CA+B0B;AAFxB,aAAa;AACb,iGAAA,IAAI,OAAA"}
+{"version":3,"file":"re-exports.js","sourceRoot":"","sources":["../src/re-exports.ts"],"names":[],"mappings":";;;AAAA,8CAgC0B;AAFxB,aAAa;AACb,iGAAA,IAAI,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typia",
-  "version": "12.0.0-dev.20260307",
+  "version": "12.0.0-dev.20260309",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "exports": {
@@ -50,10 +50,10 @@
     "inquirer": "^8.2.5",
     "package-manager-detector": "^0.2.0",
     "randexp": "^0.5.3",
-    "@typia/core": "^12.0.0-dev.20260307",
-    "@typia/interface": "^12.0.0-dev.20260307",
-    "@typia/transform": "^12.0.0-dev.20260307",
-    "@typia/utils": "^12.0.0-dev.20260307"
+    "@typia/interface": "^12.0.0-dev.20260309",
+    "@typia/utils": "^12.0.0-dev.20260309",
+    "@typia/transform": "^12.0.0-dev.20260309",
+    "@typia/core": "^12.0.0-dev.20260309"
   },
   "peerDependencies": {
     "typescript": ">=4.8.0 <5.10.0"

package/src/internal/_coerceLlmArguments.ts

@@ -0,0 +1,7 @@
+import { ILlmSchema } from "@typia/interface";
+import { LlmJson } from "@typia/utils";
+
+export const _coerceLlmArguments = <T>(
+  value: unknown,
+  parameters: ILlmSchema.IParameters,
+): T => LlmJson.coerce(value, parameters);

package/src/internal/_llmApplicationFinalize.ts

@@ -18,6 +18,7 @@ export const _llmApplicationFinalize = <Class extends object = any>(
     ...func,
     parse: (input: string): IJsonParseResult<unknown> =>
       LlmJson.parse(input, func.parameters),
+    coerce: (input: unknown): unknown => LlmJson.coerce(input, func.parameters),
     validate: config?.validate?.[func.name] ?? func.validate,
   })),
 });

package/src/internal/_parseLlmArguments.ts

@@ -0,0 +1,7 @@
+import { IJsonParseResult, ILlmSchema } from "@typia/interface";
+import { LlmJson } from "@typia/utils";
+
+export const _parseLlmArguments = <T>(
+  input: string,
+  parameters: ILlmSchema.IParameters,
+): IJsonParseResult<T> => LlmJson.parse(input, parameters);

package/src/llm.ts

@@ -1,4 +1,9 @@
-import { ILlmApplication, ILlmController, ILlmSchema } from "@typia/interface";
+import {
+  IJsonParseResult,
+  ILlmApplication,
+  ILlmController,
+  ILlmSchema,
+} from "@typia/interface";
 
 import { NoTransformConfigurationError } from "./transformers/NoTransformConfigurationError";
 
@@ -209,3 +214,195 @@ export function schema<T, Config extends Partial<ILlmSchema.IConfig> = {}>(
 export function schema(): never {
   NoTransformConfigurationError("llm.schema");
 }
+
+/**
+ * Parse LLM response JSON with type coercion.
+ *
+ * @danger You must configure the generic argument `Parameters`
+ */
+export function parse(input: string): never;
+
+/**
+ * Parse lenient JSON with schema-based type coercion.
+ *
+ * Handles incomplete or malformed JSON commonly produced by LLMs:
+ *
+ * - Unclosed brackets, strings, trailing commas
+ * - JavaScript-style comments (`//` and multi-line)
+ * - Unquoted object keys, incomplete keywords (`tru`, `fal`, `nul`)
+ * - Markdown code block extraction, junk prefix skipping
+ *
+ * Also coerces double-stringified values based on the `Parameters` schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * For repeated parsing, use {@link createParse} to avoid regenerating the schema
+ * each time.
+ *
+ * Related functions:
+ *
+ * - {@link createParse} — Create reusable parser function
+ * - {@link coerce} — Type coercion for already-parsed objects
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @param input Raw JSON string (potentially incomplete or malformed)
+ * @returns Parse result with typed data on success, or partial data with errors
+ */
+export function parse<
+  Parameters extends Record<string, any>,
+  Config extends Partial<ILlmSchema.IConfig> = {},
+>(input: string): IJsonParseResult<Parameters>;
+
+/** @internal */
+export function parse(): never {
+  NoTransformConfigurationError("llm.parse");
+}
+
+/**
+ * Coerce LLM arguments to match expected schema types.
+ *
+ * LLMs often return values with incorrect types (e.g., numbers as strings).
+ * This function recursively coerces values based on the `Parameters` schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Use this when your SDK provides already-parsed objects but values may have
+ * wrong types. For raw JSON strings, use {@link parse} instead.
+ *
+ * For repeated coercion, use {@link createCoerce} to avoid regenerating the
+ * schema each time.
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * Related functions:
+ *
+ * - {@link createCoerce} — Create reusable coercer function
+ * - {@link parse} — Parse and coerce raw JSON strings
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @param input Parsed arguments object from LLM (with potentially wrong types)
+ * @returns Coerced arguments with corrected types
+ */
+export function coerce<
+  Parameters extends Record<string, any>,
+  Config extends Partial<ILlmSchema.IConfig> = {},
+>(input: Parameters): Parameters;
+
+/** @internal */
+export function coerce(): never {
+  NoTransformConfigurationError("llm.coerce");
+}
+
+/**
+ * Create reusable LLM JSON parser with type coercion.
+ *
+ * @danger You must configure the generic argument `Parameters`
+ */
+export function createParse(): never;
+
+/**
+ * Create reusable lenient JSON parser with schema-based type coercion.
+ *
+ * Returns a parser function that handles incomplete or malformed JSON commonly
+ * produced by LLMs:
+ *
+ * - Unclosed brackets, strings, trailing commas
+ * - JavaScript-style comments (`//` and multi-line)
+ * - Unquoted object keys, incomplete keywords (`tru`, `fal`, `nul`)
+ * - Markdown code block extraction, junk prefix skipping
+ *
+ * Also coerces double-stringified values based on the `Parameters` schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Use this instead of {@link parse} when parsing multiple inputs to avoid
+ * regenerating the schema each time.
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * Related functions:
+ *
+ * - {@link parse} — One-shot parsing (regenerates schema each call)
+ * - {@link createCoerce} — Create reusable coercer function
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @returns Reusable parser function
+ */
+export function createParse<
+  Parameters extends Record<string, any>,
+  Config extends Partial<ILlmSchema.IConfig> = {},
+>(): (input: string) => IJsonParseResult<Parameters>;
+
+/** @internal */
+export function createParse(): never {
+  NoTransformConfigurationError("llm.createParse");
+}
+
+/**
+ * Create reusable LLM arguments coercer.
+ *
+ * @danger You must configure the generic argument `Parameters`
+ */
+export function createCoerce(): never;
+
+/**
+ * Create reusable coercer for LLM arguments.
+ *
+ * Returns a coercer function that fixes incorrect types commonly returned by
+ * LLMs (e.g., numbers as strings). Coerces values based on the `Parameters`
+ * schema:
+ *
+ * - `"42"` → `42` (when schema expects number)
+ * - `"true"` → `true` (when schema expects boolean)
+ * - `"null"` → `null` (when schema expects null)
+ * - `"{...}"` → `{...}` (when schema expects object)
+ * - `"[...]"` → `[...]` (when schema expects array)
+ *
+ * Use this instead of {@link coerce} when coercing multiple inputs to avoid
+ * regenerating the schema each time.
+ *
+ * Type validation is NOT performed—use {@link ILlmFunction.validate} or
+ * `typia.validate()` for that.
+ *
+ * Related functions:
+ *
+ * - {@link coerce} — One-shot coercion (regenerates schema each call)
+ * - {@link createParse} — Create reusable parser function
+ * - {@link parameters} — Generate parameters schema from type
+ *
+ * @template Parameters Target parameters type (object with static properties)
+ * @template Config LLM schema configuration
+ * @returns Reusable coercer function
+ */
+export function createCoerce<
+  Parameters extends Record<string, any>,
+  Config extends Partial<ILlmSchema.IConfig> = {},
+>(): (input: Parameters) => Parameters;
+
+/** @internal */
+export function createCoerce(): never {
+  NoTransformConfigurationError("llm.createCoerce");
+}

package/src/re-exports.ts

@@ -1,6 +1,7 @@
 export {
   // validate
   AssertionGuard,
+  IJsonParseResult,
   IValidation,
   IRandomGenerator,
   // json