@typia/utils 12.0.0-dev.20260306 → 12.0.0-dev.20260307

package/lib/utils/LlmJson.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmJson = void 0;
+const converters_1 = require("../converters");
+const validators_1 = require("../validators");
+const coerceLlmArguments_1 = require("./internal/coerceLlmArguments");
+const parseLenientJson_1 = require("./internal/parseLenientJson");
+const stringifyValidationFailure_1 = require("./internal/stringifyValidationFailure");
+/**
+ * JSON utilities for LLM function calling.
+ *
+ * - {@link LlmJson.parse}: Lenient JSON parser for incomplete/malformed JSON
+ * - {@link LlmJson.stringify}: Format validation errors for LLM feedback
+ * - {@link LlmJson.validate}: Create a reusable validator from schema
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var LlmJson;
+(function (LlmJson) {
+    /**
+     * Parse lenient JSON with optional schema-based coercion.
+     *
+     * Handles incomplete/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
+     *
+     * When `parameters` schema is provided, also coerces double-stringified
+     * values: `"42"` → `42`, `"true"` → `true`, `"{...}"` → `{...}` based on
+     * expected types.
+     *
+     * Type validation is NOT performed - use {@link ILlmFunction.validate}.
+     *
+     * @param input Raw JSON string (potentially incomplete or malformed)
+     * @param parameters Optional LLM parameters schema for type coercion
+     * @returns Parse result with data on success, or partial data with errors
+     */
+    function parse(input, parameters) {
+        const result = (0, parseLenientJson_1.parseLenientJson)(input);
+        // Apply schema-based coercion if parameters provided and parsing succeeded
+        if (parameters !== undefined && result.success) {
+            return {
+                success: true,
+                data: (0, coerceLlmArguments_1.coerceLlmArguments)(result.data, parameters),
+            };
+        }
+        return result;
+    }
+    LlmJson.parse = parse;
+    /**
+     * Format validation failure for LLM auto-correction feedback.
+     *
+     * When LLM generates invalid function call arguments, this produces annotated
+     * JSON with inline `// ❌` error comments at each invalid property. The output
+     * is wrapped in a markdown code block so that LLM can understand and correct
+     * its mistakes in the next turn.
+     *
+     * Below is an example of the output format:
+     *
+     * ```json
+     * {
+     *   "name": "John",
+     *   "age": "twenty", // ❌ [{"path":"$input.age","expected":"number & Type<\"uint32\">"}]
+     *   "email": "not-an-email", // ❌ [{"path":"$input.email","expected":"string & Format<\"email\">"}]
+     *   "hobbies": "reading" // ❌ [{"path":"$input.hobbies","expected":"Array<string>"}]
+     * }
+     * ```
+     *
+     * @param failure Validation failure from {@link ILlmFunction.validate}
+     */
+    function stringify(failure) {
+        return (0, stringifyValidationFailure_1.stringifyValidationFailure)(failure);
+    }
+    LlmJson.stringify = stringify;
+    /**
+     * Create a reusable validator from LLM parameters schema.
+     *
+     * When validation fails, format the failure with {@link stringify} for LLM
+     * auto-correction feedback.
+     *
+     * @param parameters LLM function parameters schema
+     * @param equals If `true`, reject extraneous properties not defined in the
+     *   schema. Otherwise, extra properties are ignored.
+     * @returns Validator function that checks data against the schema
+     */
+    function validate(parameters, equals) {
+        const components = {
+            schemas: {},
+        };
+        const schema = converters_1.LlmSchemaConverter.invert({
+            components,
+            schema: parameters,
+            $defs: parameters.$defs,
+        });
+        return validators_1.OpenApiValidator.create({
+            components,
+            schema,
+            required: true,
+            equals,
+        });
+    }
+    LlmJson.validate = validate;
+})(LlmJson || (exports.LlmJson = LlmJson = {}));
+//# sourceMappingURL=LlmJson.js.map

package/lib/utils/LlmJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmJson.js","sourceRoot":"","sources":["../../src/utils/LlmJson.ts"],"names":[],"mappings":";;;AAOA,8CAAmD;AACnD,8CAAiD;AACjD,sEAAmE;AACnE,kEAA+D;AAC/D,sFAAmF;AAEnF;;;;;;;;GAQG;AACH,IAAiB,OAAO,CA4FvB;AA5FD,WAAiB,OAAO;IACtB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAgB,KAAK,CACnB,KAAa,EACb,UAAmC;QAEnC,MAAM,MAAM,GAAwB,IAAA,mCAAgB,EAAI,KAAK,CAAC,CAAC;QAE/D,2EAA2E;QAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAA,uCAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAM;aACvD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAde,aAAK,QAcpB,CAAA;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,SAAS,CAAC,OAA6B;QACrD,OAAO,IAAA,uDAA0B,EAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAFe,iBAAS,YAExB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,QAAQ,CACtB,UAAkC,EAClC,MAA4B;QAE5B,MAAM,UAAU,GAAwB;YACtC,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,MAAM,MAAM,GAAwB,+BAAkB,CAAC,MAAM,CAAC;YAC5D,UAAU;YACV,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAC;QACH,OAAO,6BAAgB,CAAC,MAAM,CAAC;YAC7B,UAAU;YACV,MAAM;YACN,QAAQ,EAAE,IAAI;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAlBe,gBAAQ,WAkBvB,CAAA;AACH,CAAC,EA5FgB,OAAO,uBAAP,OAAO,QA4FvB"}

package/lib/utils/LlmJson.mjs

@@ -0,0 +1,113 @@
+import { LlmSchemaConverter } from '../converters/LlmSchemaConverter.mjs';
+import '../converters/OpenApiConverter.mjs';
+import '../converters/internal/OpenApiExclusiveEmender.mjs';
+import '../validators/LlmTypeChecker.mjs';
+import '../validators/OpenApiTypeChecker.mjs';
+import '../validators/OpenApiV3TypeChecker.mjs';
+import '../validators/OpenApiV3_1TypeChecker.mjs';
+import '../validators/SwaggerV2TypeChecker.mjs';
+import { OpenApiValidator } from '../validators/OpenApiValidator.mjs';
+import { coerceLlmArguments } from './internal/coerceLlmArguments.mjs';
+import { parseLenientJson } from './internal/parseLenientJson.mjs';
+import { stringifyValidationFailure } from './internal/stringifyValidationFailure.mjs';
+
+/**
+ * JSON utilities for LLM function calling.
+ *
+ * - {@link LlmJson.parse}: Lenient JSON parser for incomplete/malformed JSON
+ * - {@link LlmJson.stringify}: Format validation errors for LLM feedback
+ * - {@link LlmJson.validate}: Create a reusable validator from schema
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var LlmJson;
+(function (LlmJson) {
+    /**
+     * Parse lenient JSON with optional schema-based coercion.
+     *
+     * Handles incomplete/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
+     *
+     * When `parameters` schema is provided, also coerces double-stringified
+     * values: `"42"` → `42`, `"true"` → `true`, `"{...}"` → `{...}` based on
+     * expected types.
+     *
+     * Type validation is NOT performed - use {@link ILlmFunction.validate}.
+     *
+     * @param input Raw JSON string (potentially incomplete or malformed)
+     * @param parameters Optional LLM parameters schema for type coercion
+     * @returns Parse result with data on success, or partial data with errors
+     */
+    function parse(input, parameters) {
+        const result = parseLenientJson(input);
+        // Apply schema-based coercion if parameters provided and parsing succeeded
+        if (parameters !== undefined && result.success) {
+            return {
+                success: true,
+                data: coerceLlmArguments(result.data, parameters),
+            };
+        }
+        return result;
+    }
+    LlmJson.parse = parse;
+    /**
+     * Format validation failure for LLM auto-correction feedback.
+     *
+     * When LLM generates invalid function call arguments, this produces annotated
+     * JSON with inline `// ❌` error comments at each invalid property. The output
+     * is wrapped in a markdown code block so that LLM can understand and correct
+     * its mistakes in the next turn.
+     *
+     * Below is an example of the output format:
+     *
+     * ```json
+     * {
+     *   "name": "John",
+     *   "age": "twenty", // ❌ [{"path":"$input.age","expected":"number & Type<\"uint32\">"}]
+     *   "email": "not-an-email", // ❌ [{"path":"$input.email","expected":"string & Format<\"email\">"}]
+     *   "hobbies": "reading" // ❌ [{"path":"$input.hobbies","expected":"Array<string>"}]
+     * }
+     * ```
+     *
+     * @param failure Validation failure from {@link ILlmFunction.validate}
+     */
+    function stringify(failure) {
+        return stringifyValidationFailure(failure);
+    }
+    LlmJson.stringify = stringify;
+    /**
+     * Create a reusable validator from LLM parameters schema.
+     *
+     * When validation fails, format the failure with {@link stringify} for LLM
+     * auto-correction feedback.
+     *
+     * @param parameters LLM function parameters schema
+     * @param equals If `true`, reject extraneous properties not defined in the
+     *   schema. Otherwise, extra properties are ignored.
+     * @returns Validator function that checks data against the schema
+     */
+    function validate(parameters, equals) {
+        const components = {
+            schemas: {},
+        };
+        const schema = LlmSchemaConverter.invert({
+            components,
+            schema: parameters,
+            $defs: parameters.$defs,
+        });
+        return OpenApiValidator.create({
+            components,
+            schema,
+            required: true,
+            equals,
+        });
+    }
+    LlmJson.validate = validate;
+})(LlmJson || (LlmJson = {}));
+
+export { LlmJson };
+//# sourceMappingURL=LlmJson.mjs.map

package/lib/utils/LlmJson.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmJson.mjs","sources":["../../src/utils/LlmJson.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;AAaA;;;;;;;;AAQG;AACG,IAAW;AAAjB,CAAA,UAAiB,OAAO,EAAA;AACtB;;;;;;;;;;;;;;;;;;;AAmBG;AACH,IAAA,SAAgB,KAAK,CACnB,KAAa,EACb,UAAmC,EAAA;AAEnC,QAAA,MAAM,MAAM,GAAwB,gBAAgB,CAAI,KAAK,CAAC;;QAG9D,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE;YAC9C,OAAO;AACL,gBAAA,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAM;aACvD;QACH;AACA,QAAA,OAAO,MAAM;IACf;AAdgB,IAAA,OAAA,CAAA,KAAK,QAcpB;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;IACH,SAAgB,SAAS,CAAC,OAA6B,EAAA;AACrD,QAAA,OAAO,0BAA0B,CAAC,OAAO,CAAC;IAC5C;AAFgB,IAAA,OAAA,CAAA,SAAS,YAExB;AAED;;;;;;;;;;AAUG;AACH,IAAA,SAAgB,QAAQ,CACtB,UAAkC,EAClC,MAA4B,EAAA;AAE5B,QAAA,MAAM,UAAU,GAAwB;AACtC,YAAA,OAAO,EAAE,EAAE;SACZ;AACD,QAAA,MAAM,MAAM,GAAwB,kBAAkB,CAAC,MAAM,CAAC;YAC5D,UAAU;AACV,YAAA,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU,CAAC,KAAK;AACxB,SAAA,CAAC;QACF,OAAO,gBAAgB,CAAC,MAAM,CAAC;YAC7B,UAAU;YACV,MAAM;AACN,YAAA,QAAQ,EAAE,IAAI;YACd,MAAM;AACP,SAAA,CAAC;IACJ;AAlBgB,IAAA,OAAA,CAAA,QAAQ,WAkBvB;AACH,CAAC,EA5FgB,OAAO,KAAP,OAAO,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/utils/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./ArrayUtil";
+export * from "./LlmJson";
 export * from "./MapUtil";
 export * from "./NamingConvention";
 export * from "./Singleton";
 export * from "./StringUtil";
 export * from "./dedent";
-export * from "./stringifyValidationFailure";

package/lib/utils/index.js

@@ -15,10 +15,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ArrayUtil"), exports);
+__exportStar(require("./LlmJson"), exports);
 __exportStar(require("./MapUtil"), exports);
 __exportStar(require("./NamingConvention"), exports);
 __exportStar(require("./Singleton"), exports);
 __exportStar(require("./StringUtil"), exports);
 __exportStar(require("./dedent"), exports);
-__exportStar(require("./stringifyValidationFailure"), exports);
 //# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,qDAAmC;AACnC,8CAA4B;AAC5B,+CAA6B;AAE7B,2CAAyB;AACzB,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,4CAA0B;AAC1B,qDAAmC;AACnC,8CAA4B;AAC5B,+CAA6B;AAE7B,2CAAyB"}

package/lib/utils/index.mjs

@@ -1,8 +1,8 @@
 export { ArrayUtil } from './ArrayUtil.mjs';
+export { LlmJson } from './LlmJson.mjs';
 export { MapUtil } from './MapUtil.mjs';
 export { NamingConvention } from './NamingConvention.mjs';
 export { Singleton } from './Singleton.mjs';
 export { StringUtil } from './StringUtil.mjs';
 export { dedent } from './dedent.mjs';
-export { stringifyValidationFailure } from './stringifyValidationFailure.mjs';
 //# sourceMappingURL=index.mjs.map

package/lib/utils/internal/coerceLlmArguments.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/internal/coerceLlmArguments.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceLlmArguments = coerceLlmArguments;
+const LlmTypeChecker_1 = require("../../validators/LlmTypeChecker");
+const parseLenientJson_1 = require("./parseLenientJson");
+/**
+ * Coerce LLM arguments by parsing double-stringified JSON values.
+ *
+ * When LLM produces stringified JSON for non-string schema types, this function
+ * attempts to parse them using the lenient JSON parser.
+ *
+ * Only applies coercion when value is string but schema expects non-string.
+ * Type validation is handled separately by `ILlmFunction.validate`.
+ *
+ * @param value Parsed JSON value (potentially with stringified nested values)
+ * @param parameters LLM parameters schema
+ * @returns Coerced value with double-stringified JSON parsed
+ * @internal
+ */
+function coerceLlmArguments(value, parameters) {
+    return coerceValue(value, parameters, parameters.$defs);
+}
+function coerceValue(value, schema, $defs) {
+    // Resolve reference
+    if (LlmTypeChecker_1.LlmTypeChecker.isReference(schema)) {
+        const key = schema.$ref.replace("#/$defs/", "");
+        const resolved = $defs === null || $defs === void 0 ? void 0 : $defs[key];
+        if (resolved !== undefined) {
+            return coerceValue(value, resolved, $defs);
+        }
+        return value;
+    }
+    // Handle anyOf
+    if (LlmTypeChecker_1.LlmTypeChecker.isAnyOf(schema)) {
+        // Value is string
+        if (typeof value === "string") {
+            // If string is in union, don't parse - it's valid as-is
+            const hasString = schema.anyOf.some((s) => LlmTypeChecker_1.LlmTypeChecker.isString(resolveSchema(s, $defs)));
+            if (hasString) {
+                return value;
+            }
+            // String value but no string in union - try to parse
+            const parsed = (0, parseLenientJson_1.parseLenientJson)(value);
+            if (parsed.success) {
+                // Find uniquely matching schema via type + x-discriminator
+                const matched = findMatchingAnyOfSchema(parsed.data, schema, $defs);
+                if (matched !== undefined) {
+                    return coerceValue(parsed.data, matched, $defs);
+                }
+                return parsed.data;
+            }
+            return value;
+        }
+        // Value is object - find matching schema via discriminated union
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            const matched = findMatchingObjectInAnyOf(value, schema, $defs);
+            if (matched !== undefined) {
+                return coerceValue(value, matched, $defs);
+            }
+            return value;
+        }
+        // Value is array - find matching array schema (only if unambiguous)
+        if (Array.isArray(value)) {
+            const arraySchemas = schema.anyOf.filter((s) => LlmTypeChecker_1.LlmTypeChecker.isArray(resolveSchema(s, $defs)));
+            if (arraySchemas.length === 1) {
+                return coerceValue(value, arraySchemas[0], $defs);
+            }
+            // Multiple or no array schemas - skip coercion
+            return value;
+        }
+        // Non-string primitive or no matching schema - return as-is
+        return value;
+    }
+    // String schema - no coercion needed (value stays as-is)
+    if (LlmTypeChecker_1.LlmTypeChecker.isString(schema)) {
+        return value;
+    }
+    // Unknown schema - no coercion needed
+    if (LlmTypeChecker_1.LlmTypeChecker.isUnknown(schema)) {
+        return value;
+    }
+    // Value is string but schema is non-string - try to parse
+    if (typeof value === "string") {
+        const parsed = (0, parseLenientJson_1.parseLenientJson)(value);
+        if (parsed.success) {
+            // Continue coercion on the parsed value (for nested stringified values)
+            return coerceValue(parsed.data, schema, $defs);
+        }
+        // Parse failed, return original - validate will catch type error
+        return value;
+    }
+    // Value is array and schema is array - recurse into items
+    if (Array.isArray(value) && LlmTypeChecker_1.LlmTypeChecker.isArray(schema)) {
+        return value.map((item) => coerceValue(item, schema.items, $defs));
+    }
+    // Value is object and schema is object - recurse into properties
+    if (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        LlmTypeChecker_1.LlmTypeChecker.isObject(schema)) {
+        return coerceObject(value, schema, $defs);
+    }
+    // Everything else (null, boolean, number, integer) - return as-is
+    return value;
+}
+function coerceObject(value, schema, $defs) {
+    const result = {};
+    // Coerce known properties
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        if (key in value) {
+            result[key] = coerceValue(value[key], propSchema, $defs);
+        }
+    }
+    // Preserve additional properties - let validation handle rejection
+    const additionalSchema = typeof schema.additionalProperties === "object"
+        ? schema.additionalProperties
+        : undefined;
+    for (const key of Object.keys(value)) {
+        if (!(key in schema.properties)) {
+            result[key] = additionalSchema
+                ? coerceValue(value[key], additionalSchema, $defs)
+                : value[key];
+        }
+    }
+    return result;
+}
+function resolveSchema(schema, $defs) {
+    if (LlmTypeChecker_1.LlmTypeChecker.isReference(schema)) {
+        const key = schema.$ref.replace("#/$defs/", "");
+        const resolved = $defs === null || $defs === void 0 ? void 0 : $defs[key];
+        if (resolved !== undefined) {
+            return resolveSchema(resolved, $defs);
+        }
+    }
+    return schema;
+}
+/**
+ * Check if value roughly matches the expected schema type. Used for anyOf
+ * matching after parsing.
+ */
+function matchesSchemaType(value, schema, $defs) {
+    if (LlmTypeChecker_1.LlmTypeChecker.isReference(schema)) {
+        const key = schema.$ref.replace("#/$defs/", "");
+        const resolved = $defs === null || $defs === void 0 ? void 0 : $defs[key];
+        if (resolved)
+            return matchesSchemaType(value, resolved, $defs);
+        return false;
+    }
+    if (LlmTypeChecker_1.LlmTypeChecker.isNull(schema))
+        return value === null;
+    if (LlmTypeChecker_1.LlmTypeChecker.isBoolean(schema))
+        return typeof value === "boolean";
+    if (LlmTypeChecker_1.LlmTypeChecker.isInteger(schema))
+        return typeof value === "number" && Number.isInteger(value);
+    if (LlmTypeChecker_1.LlmTypeChecker.isNumber(schema))
+        return typeof value === "number";
+    if (LlmTypeChecker_1.LlmTypeChecker.isString(schema))
+        return typeof value === "string";
+    if (LlmTypeChecker_1.LlmTypeChecker.isArray(schema))
+        return Array.isArray(value);
+    if (LlmTypeChecker_1.LlmTypeChecker.isObject(schema))
+        return typeof value === "object" && value !== null && !Array.isArray(value);
+    if (LlmTypeChecker_1.LlmTypeChecker.isUnknown(schema))
+        return true;
+    if (LlmTypeChecker_1.LlmTypeChecker.isAnyOf(schema))
+        return schema.anyOf.some((s) => matchesSchemaType(value, s, $defs));
+    return false;
+}
+/**
+ * Find the uniquely matching schema for a value among anyOf alternatives. Uses
+ * `x-discriminator` for object disambiguation. Returns undefined if no unique
+ * match can be determined.
+ */
+function findMatchingAnyOfSchema(value, schema, $defs) {
+    const matching = schema.anyOf.filter((s) => matchesSchemaType(value, s, $defs));
+    if (matching.length === 1)
+        return matching[0];
+    if (matching.length === 0)
+        return undefined;
+    // Multiple type matches - try x-discriminator for objects
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        return findMatchingObjectInAnyOf(value, schema, $defs);
+    }
+    return undefined;
+}
+/**
+ * Find the matching object schema among anyOf using `x-discriminator`. If only
+ * one object schema exists, returns it directly. If multiple exist but no
+ * x-discriminator, gives up.
+ */
+function findMatchingObjectInAnyOf(value, schema, $defs) {
+    var _a, _b;
+    const objectSchemas = schema.anyOf.filter((s) => LlmTypeChecker_1.LlmTypeChecker.isObject(resolveSchema(s, $defs)));
+    if (objectSchemas.length === 0)
+        return undefined;
+    if (objectSchemas.length === 1)
+        return objectSchemas[0];
+    // Multiple object schemas - require x-discriminator
+    const discriminator = schema["x-discriminator"];
+    if (discriminator === undefined)
+        return undefined;
+    const key = discriminator.propertyName;
+    const discriminatorValue = value[key];
+    // Use mapping for direct $ref lookup
+    if (discriminator.mapping !== undefined &&
+        typeof discriminatorValue === "string") {
+        const ref = discriminator.mapping[discriminatorValue];
+        if (ref !== undefined) {
+            for (const s of schema.anyOf) {
+                if (LlmTypeChecker_1.LlmTypeChecker.isReference(s) && s.$ref === ref) {
+                    return s;
+                }
+            }
+        }
+        return undefined;
+    }
+    // No mapping - match by enum values on the discriminator property
+    for (const s of objectSchemas) {
+        const resolved = resolveSchema(s, $defs);
+        if (!LlmTypeChecker_1.LlmTypeChecker.isObject(resolved))
+            continue;
+        const propSchema = (_a = resolved.properties) === null || _a === void 0 ? void 0 : _a[key];
+        if (propSchema === undefined)
+            continue;
+        const resolvedProp = resolveSchema(propSchema, $defs);
+        if (LlmTypeChecker_1.LlmTypeChecker.isString(resolvedProp) &&
+            ((_b = resolvedProp.enum) === null || _b === void 0 ? void 0 : _b.includes(discriminatorValue))) {
+            return s;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=coerceLlmArguments.js.map

package/lib/utils/internal/coerceLlmArguments.js.map

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