@agentica/core 0.33.2 → 0.34.1

package/lib/index.mjs

@@ -2010,7 +2010,7 @@ const FUNCTION = {
             additionalProperties: false,
             $defs: {
                 IHttpLlmFunctionchatgpt: {
-                    description: "LLM function calling schema from HTTP (OpenAPI) operation.\n\n`IHttpLlmFunction` is a data structure representing a function converted from\nthe {@link OpenApi.IOperation OpenAPI operation}, used for the LLM (Large\nLanguage Model) function calling. It's a typical RPC (Remote Procedure Call)\nstructure containing the function {@link name}, {@link parameters}, and\n{@link output return type}.\n\nIf you provide this `IHttpLlmFunction` data to the LLM provider like\n\"OpenAI\", the \"OpenAI\" will compose a function arguments by analyzing\nconversations with the user. With the LLM composed arguments, you can execute\nthe function through {@link LlmFetcher.execute} and get the result.\n\nFor reference, different between `IHttpLlmFunction` and its origin source\n{@link OpenApi.IOperation} is, `IHttpLlmFunction` has converted every type\nschema information from {@link OpenApi.IJsonSchema} to {@link ILlmSchemaV3} to\nescape {@link OpenApi.IJsonSchema.IReference reference types}, and downgrade\nthe version of the JSON schema to OpenAPI 3.0. It's because LLM function call\nfeature cannot understand both reference types and OpenAPI 3.1\nspecification.\n\nAdditionally, the properties' rule is:\n\n- `pathParameters`: Path parameters of {@link OpenApi.IOperation.parameters}\n- `query`: Query parameter of {@link IHttpMigrateRoute.query}\n- `body`: Body parameter of {@link IHttpMigrateRoute.body}\n\n```typescript\n{\n  ...pathParameters,\n  query,\n  body,\n}\n```\n\n### Description of {@link parameters} property:\n\n> List of parameter types.\n> \n> If you've configured {@link IHttpLlmApplication.IOptions.keyword} as `true`,\n> number of {@link IHttpLlmFunction.parameters} are always 1 and the first\n> parameter's type is always {@link ILlmSchemaV3.IObject}. The properties'\n> rule is:\n> \n> - `pathParameters`: Path parameters of {@link IHttpMigrateRoute.parameters}\n> - `query`: Query parameter of {@link IHttpMigrateRoute.query}\n> - `body`: Body parameter of {@link IHttpMigrateRoute.body}\n> \n> ```typescript\n> {\n>   ...pathParameters,\n>   query,\n>   body,\n> }\n> ```\n> \n> Otherwise, the parameters would be multiple, and the sequence of the\n> parameters are following below rules:\n> \n> ```typescript\n> [\n>   ...pathParameters,\n>   ...(query ? [query] : []),\n>   ...(body ? [body] : []),\n> ];\n> ```\n\n### Description of {@link separated} property:\n\n> Collection of separated parameters.\n> \n> Filled only when {@link IHttpLlmApplication.IOptions.separate} is\n> configured.",
+                    description: 'LLM function calling schema from HTTP (OpenAPI) operation.\n\n`IHttpLlmFunction` is a data structure representing a function converted from\nthe {@link OpenApi.IOperation OpenAPI operation}, used for the LLM (Large\nLanguage Model) function calling. It\'s a typical RPC (Remote Procedure Call)\nstructure containing the function {@link name}, {@link parameters}, and\n{@link output return type}.\n\nIf you provide this `IHttpLlmFunction` data to the LLM provider like\n"OpenAI", the "OpenAI" will compose a function arguments by analyzing\nconversations with the user. With the LLM composed arguments, you can execute\nthe function through {@link LlmFetcher.execute} and get the result.\n\nFor reference, different between `IHttpLlmFunction` and its origin source\n{@link OpenApi.IOperation} is, `IHttpLlmFunction` has converted every type\nschema information from {@link OpenApi.IJsonSchema} to {@link ILlmSchemaV3} to\nescape {@link OpenApi.IJsonSchema.IReference reference types}, and downgrade\nthe version of the JSON schema to OpenAPI 3.0. It\'s because LLM function call\nfeature cannot understand both reference types and OpenAPI 3.1\nspecification.\n\nAdditionally, the properties\' rule is:\n\n- `pathParameters`: Path parameters of {@link OpenApi.IOperation.parameters}\n- `query`: Query parameter of {@link IHttpMigrateRoute.query}\n- `body`: Body parameter of {@link IHttpMigrateRoute.body}\n\n```typescript\n{\n  ...pathParameters,\n  query,\n  body,\n}\n```',
                     type: "object",
                     properties: {
                         method: {
@@ -2027,21 +2027,23 @@ const FUNCTION = {
                             type: "string"
                         },
                         parameters: {
+                            description: "List of parameter types.\n\nIf you've configured {@link IHttpLlmApplication.IOptions.keyword} as `true`,\nnumber of {@link IHttpLlmFunction.parameters} are always 1 and the first\nparameter's type is always {@link ILlmSchemaV3.IObject}. The properties'\nrule is:\n\n- `pathParameters`: Path parameters of {@link IHttpMigrateRoute.parameters}\n- `query`: Query parameter of {@link IHttpMigrateRoute.query}\n- `body`: Body parameter of {@link IHttpMigrateRoute.body}\n\n```typescript\n{\n  ...pathParameters,\n  query,\n  body,\n}\n```\n\nOtherwise, the parameters would be multiple, and the sequence of the\nparameters are following below rules:\n\n```typescript\n[\n  ...pathParameters,\n  ...(query ? [query] : []),\n  ...(body ? [body] : []),\n];\n```",
                             $ref: "#/$defs/IChatGptSchema.IParameters"
                         },
                         separated: {
+                            description: "Collection of separated parameters.\n\nFilled only when {@link IHttpLlmApplication.IOptions.separate} is\nconfigured.",
                             $ref: "#/$defs/IHttpLlmFunction.ISeparatedchatgpt"
                         },
                         output: {
                             description: "Expected return type.\n\nIf the target operation returns nothing (`void`), the `output` would be\n`undefined`.",
                             anyOf: [ {
-                                $ref: "#/$defs/IChatGptSchema.IString"
-                            }, {
                                 $ref: "#/$defs/IChatGptSchema.INumber"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.IInteger"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.IBoolean"
+                            }, {
+                                $ref: "#/$defs/IChatGptSchema.IString"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.IArray"
                             }, {
@@ -2075,10 +2077,11 @@ const FUNCTION = {
                     required: [ "method", "path", "name", "parameters" ]
                 },
                 "IChatGptSchema.IParameters": {
-                    description: "Type for function parameters.\n\n`IChatGptSchema.IParameters` defines a function's parameters as\na keyword object type, where each property represents a named parameter.\n\nIt can also be used for structured output metadata to define the\nexpected format of ChatGPT responses.\n\n### Description of {@link $defs} property:\n\n> Collection of the named types.\n\n### Description of {@link properties} property:\n\n> Properties of the object.\n> \n> The `properties` means a list of key-value pairs of the object's regular\n> properties. The key is the name of the regular property, and the value is\n> the type schema info.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Type for function parameters.\n\n`IChatGptSchema.IParameters` defines a function's parameters as a keyword\nobject type, where each property represents a named parameter.\n\nIt can also be used for structured output metadata to define the expected\nformat of ChatGPT responses.",
                     type: "object",
                     properties: {
                         $defs: {
+                            description: "Collection of the named types.",
                             $ref: "#/$defs/RecordstringIChatGptSchema"
                         },
                         additionalProperties: {
@@ -2092,6 +2095,7 @@ const FUNCTION = {
                             enum: [ "object" ]
                         },
                         properties: {
+                            description: "Properties of the object.\n\nThe `properties` means a list of key-value pairs of the object's regular\nproperties. The key is the name of the regular property, and the value is\nthe type schema info.",
                             $ref: "#/$defs/RecordstringIChatGptSchema"
                         },
                         required: {
@@ -2117,6 +2121,7 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
@@ -2132,7 +2137,7 @@ const FUNCTION = {
                     }
                 },
                 IChatGptSchema: {
-                    description: 'Type schema info of the ChatGPT.\n\n`IChatGptSchema` is a type schema info of the ChatGPT function calling.\n\n`IChatGptSchema` basically follows the JSON schema definition of the OpenAPI\nv3.1 specification; {@link OpenApiV3_1.IJsonSchema}.\n\nHowever, the `IChatGptSchema` does not follow the entire specification of the\nOpenAPI v3.1. It has own specific restrictions and definitions. Here is the\nlist of how `IChatGptSchema` is different with the OpenAPI v3.1 JSON schema.\n\n- Decompose mixed type: {@link OpenApiV3_1.IJsonSchema.IMixed}\n- Resolve nullable property:\n  {@link OpenApiV3_1.IJsonSchema.__ISignificant.nullable}\n- Tuple type is banned: {@link OpenApiV3_1.IJsonSchema.ITuple.prefixItems}\n- Constant type is banned: {@link OpenApiV3_1.IJsonSchema.IConstant}\n- Merge {@link OpenApiV3_1.IJsonSchema.IOneOf} to {@link IChatGptSchema.IAnyOf}\n- Merge {@link OpenApiV3_1.IJsonSchema.IAllOf} to {@link IChatGptSchema.IObject}\n- Merge {@link OpenApiV3_1.IJsonSchema.IRecursiveReference} to\n  {@link IChatGptSchema.IReference}\n- When {@link IChatGptSchema.IConfig.strict} mode:\n  - Every object properties must be required\n  - Do not allow {@link IChatGptSchema.IObject.additionalProperties}\n\nCompared to {@link OpenApi.IJsonSchema}, the emended JSON schema\nspecification:\n\n- {@link IChatGptSchema.IAnyOf} instead of {@link OpenApi.IJsonSchema.IOneOf}\n- {@link IChatGptSchema.IParameters.$defs} instead of\n  {@link OpenApi.IJsonSchema.IComponents.schemas}\n- {@link IChatGptSchema.IString.enum} instead of\n  {@link OpenApi.IJsonSchema.IConstant}\n- {@link IChatGptSchema.additionalProperties} is fixed to `false`\n- No tuple type {@link OpenApi.IJsonSchema.ITuple} support\n- When {@link IChatGptSchema.IConfig.strict} mode:\n  - Every object properties must be required\n  - Do not allow {@link IChatGptSchema.IObject.additionalProperties}\n\nFor reference, if you compose the `IChatGptSchema` type with the\n{@link IChatGptSchema.IConfig.reference} `false` option (default is `false`),\nonly recursively named types are archived into the\n{@link IChatGptSchema.IParameters.$defs}, and others are escaped from\nthe {@link IChatGptSchema.IReference} type.\n\nAlso, OpenAI has banned the following constraint properties. Instead,\n`IChatGptSchema` fills the {@link IChatGptSchema.__IAttribute.description}\nproperty with comment text like `"@format uuid"`.\n\n- {@link OpenApi.IJsonSchema.INumber.minimum}\n- {@link OpenApi.IJsonSchema.INumber.maximum}\n- {@link OpenApi.IJsonSchema.INumber.multipleOf}\n- {@link OpenApi.IJsonSchema.IString.minLength}\n- {@link OpenApi.IJsonSchema.IString.maxLength}\n- {@link OpenApi.IJsonSchema.IString.format}\n- {@link OpenApi.IJsonSchema.IString.pattern}\n- {@link OpenApi.IJsonSchema.IString.contentMediaType}\n- {@link OpenApi.IJsonSchema.IString.default}\n- {@link OpenApi.IJsonSchema.IArray.minItems}\n- {@link OpenApi.IJsonSchema.IArray.maxItems}\n- {@link OpenApi.IJsonSchema.IArray.unique}\n\nAdditionally, OpenAI cannot define the `description` property for the\n{@link IChatGptSchema.IReference} type, and does not understand\nencapsulation of the {@link IChatGptSchema.IAnyOf} type. Therefore, the\n`description` is written to the parent object type, not the reference type.\n\n```json\n{\n  "type": "object",\n  "description": "### Description of {@link something} property.\\n\\n> Hello?",\n  "properties": {\n    "something": {\n      "$ref": "#/$defs/SomeObject"\n    }\n  }\n}\n```',
+                    description: 'Type schema info for OpenAI function calling.\n\n`IChatGptSchema` is a type schema info for OpenAI function calling. The type\nname "ChatGpt" is intentionally used to avoid confusion with "OpenAPI"\nspecification, even though this is designed for OpenAI models.\n\n`IChatGptSchema` basically follows the JSON schema definition of the OpenAPI\nv3.1 specification; {@link OpenApiV3_1.IJsonSchema}. However, it deviates from\nthe standard JSON schema specification and omits many features when used in\n{@link IChatGptSchema.IConfig.strict} mode for OpenAI function calling.\n\n`IChatGptSchema` supports all JSON schema features through workaround\nexpressions using JSDoc tags in the `description` property, so using\n`IChatGptSchema` does not degrade function calling performance even in strict\nmode.\n\nHere is the list of how `IChatGptSchema` is different with the OpenAPI v3.1\nJSON schema:\n\n- Decompose mixed type: {@link OpenApiV3_1.IJsonSchema.IMixed}\n- Resolve nullable property:\n  {@link OpenApiV3_1.IJsonSchema.__ISignificant.nullable}\n- Tuple type is banned: {@link OpenApiV3_1.IJsonSchema.ITuple.prefixItems}\n- Constant type is banned: {@link OpenApiV3_1.IJsonSchema.IConstant}\n- Merge {@link OpenApiV3_1.IJsonSchema.IOneOf} to {@link IChatGptSchema.IAnyOf}\n- Merge {@link OpenApiV3_1.IJsonSchema.IAllOf} to {@link IChatGptSchema.IObject}\n- Merge {@link OpenApiV3_1.IJsonSchema.IRecursiveReference} to\n  {@link IChatGptSchema.IReference}\n- When {@link IChatGptSchema.IConfig.strict} mode:\n\n  - Every object properties must be required\n  - Do not allow {@link IChatGptSchema.IObject.additionalProperties}\n\nCompared to {@link OpenApi.IJsonSchema}, the emended JSON schema\nspecification:\n\n- {@link IChatGptSchema.IAnyOf} instead of {@link OpenApi.IJsonSchema.IOneOf}\n- {@link IChatGptSchema.IParameters.$defs} instead of\n  {@link OpenApi.IComponents.schemas}\n- {@link IChatGptSchema.IString.enum} instead of\n  {@link OpenApi.IJsonSchema.IConstant}\n- {@link IChatGptSchema.additionalProperties} is fixed to `false` in strict mode\n- {@link IChatGptSchema.properties} and {@link IChatGptSchema.required} are\n  always defined\n- No tuple type {@link OpenApi.IJsonSchema.ITuple} support\n- When {@link IChatGptSchema.IConfig.strict} mode:\n\n  - Every object properties must be required\n  - Do not allow {@link IChatGptSchema.IObject.additionalProperties}\n\nFor reference, if you compose the `IChatGptSchema` type with the\n{@link IChatGptSchema.IConfig.reference} `false` option (default is `false`),\nonly recursively named types are archived into the\n{@link IChatGptSchema.IParameters.$defs}, and others are escaped from the\n{@link IChatGptSchema.IReference} type.\n\nAlso, OpenAI has banned the following constraint properties. Instead,\n`IChatGptSchema` fills the {@link IChatGptSchema.description} property with\nworkaround expressions using JSDoc tags like `"@format uuid"` to convey these\nconstraints:\n\n- {@link OpenApi.IJsonSchema.INumber.minimum}\n- {@link OpenApi.IJsonSchema.INumber.maximum}\n- {@link OpenApi.IJsonSchema.INumber.multipleOf}\n- {@link OpenApi.IJsonSchema.IString.minLength}\n- {@link OpenApi.IJsonSchema.IString.maxLength}\n- {@link OpenApi.IJsonSchema.IString.format}\n- {@link OpenApi.IJsonSchema.IString.pattern}\n- {@link OpenApi.IJsonSchema.IString.contentMediaType}\n- {@link OpenApi.IJsonSchema.IString.default}\n- {@link OpenApi.IJsonSchema.IArray.minItems}\n- {@link OpenApi.IJsonSchema.IArray.maxItems}\n- {@link OpenApi.IJsonSchema.IArray.unique}\n\nAdditionally, OpenAI cannot define the {@link IChatGptSchema.description}\nproperty for the {@link IChatGptSchema.IReference} type, and does not\nunderstand encapsulation of the {@link IChatGptSchema.IAnyOf} type. Therefore,\nthe {@link IChatGptSchema.description} is written to the parent object type,\nnot the reference type.\n\n```json\n{\n  "type": "object",\n  "description": "### Description of {@link something} property.\\n\\n> Hello?",\n  "properties": {\n    "something": {\n      "$ref": "#/$defs/SomeObject"\n    }\n  }\n}\n```',
                     anyOf: [ {
                         $ref: "#/$defs/IChatGptSchema.IBoolean"
                     }, {
@@ -2156,7 +2161,7 @@ const FUNCTION = {
                     } ]
                 },
                 "IChatGptSchema.IBoolean": {
-                    description: "Boolean type info.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Boolean type info.",
                     type: "object",
                     properties: {
                         enum: {
@@ -2187,6 +2192,7 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
@@ -2200,7 +2206,7 @@ const FUNCTION = {
                     additionalProperties: {}
                 },
                 "IChatGptSchema.IInteger": {
-                    description: "Integer type info.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Integer type info.",
                     type: "object",
                     properties: {
                         enum: {
@@ -2231,13 +2237,14 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "type" ]
                 },
                 "IChatGptSchema.INumber": {
-                    description: "Number (double) type info.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Number (double) type info.",
                     type: "object",
                     properties: {
                         enum: {
@@ -2268,13 +2275,14 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "type" ]
                 },
                 "IChatGptSchema.IString": {
-                    description: "String type info.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "String type info.",
                     type: "object",
                     properties: {
                         enum: {
@@ -2284,6 +2292,10 @@ const FUNCTION = {
                                 type: "string"
                             }
                         },
+                        default: {
+                            description: "Default value.",
+                            type: "string"
+                        },
                         type: {
                             description: "Discriminator value of the type.",
                             type: "string",
@@ -2305,16 +2317,18 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "type" ]
                 },
                 "IChatGptSchema.IArray": {
-                    description: "Array type info.\n\n### Description of {@link items} property:\n\n> Items type info.\n> \n> The `items` means the type of the array elements. In other words, it is\n> the type schema info of the `T` in the TypeScript array type `Array<T>`.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Array type info.",
                     type: "object",
                     properties: {
                         items: {
+                            description: "Items type info.\n\nThe `items` means the type of the array elements. In other words, it is\nthe type schema info of the `T` in the TypeScript array type `Array<T>`.",
                             $ref: "#/$defs/IChatGptSchema"
                         },
                         type: {
@@ -2338,30 +2352,32 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "items", "type" ]
                 },
                 "IChatGptSchema.IObject": {
-                    description: "Object type info.\n\n### Description of {@link properties} property:\n\n> Properties of the object.\n> \n> The `properties` means a list of key-value pairs of the object's regular\n> properties. The key is the name of the regular property, and the value is\n> the type schema info.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Object type info.",
                     type: "object",
                     properties: {
                         properties: {
+                            description: "Properties of the object.\n\nThe `properties` means a list of key-value pairs of the object's regular\nproperties. The key is the name of the regular property, and the value is\nthe type schema info.",
                             $ref: "#/$defs/RecordstringIChatGptSchema"
                         },
                         additionalProperties: {
-                            description: "Additional properties information.\n\nThe `additionalProperties` defines the type schema for additional\nproperties that are not listed in the {@link properties}.\n\nNote: If you've configured {@link IChatGptSchema.IConfig.strict} as\n`true`, ChatGPT function calling does not support dynamic key typed\nproperties, so `additionalProperties` is always `false`.",
+                            description: "Additional properties information.\n\nThe `additionalProperties` defines the type schema for additional\nproperties that are not listed in the {@link properties}.\n\nIf the value is `true`, it means that the additional properties are not\nrestricted. They can be any type. Otherwise, if the value is\n{@link IChatGptSchema} type, it means that the additional properties must\nfollow the type schema info.\n\n- `true`: `Record<string, any>`\n- `IChatGptSchema`: `Record<string, T>`\n\nNote: If you've configured {@link IChatGptSchema.IConfig.strict} as\n`true`, ChatGPT function calling does not support dynamic key typed\nproperties, so `additionalProperties` is always `false`.",
                             anyOf: [ {
                                 type: "boolean"
-                            }, {
-                                $ref: "#/$defs/IChatGptSchema.IString"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.INumber"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.IInteger"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.IBoolean"
+                            }, {
+                                $ref: "#/$defs/IChatGptSchema.IString"
                             }, {
                                 $ref: "#/$defs/IChatGptSchema.IArray"
                             }, {
@@ -2404,17 +2420,18 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "properties", "required", "type" ]
                 },
                 "IChatGptSchema.IReference": {
-                    description: "Reference type directing to named schema.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Reference type directing to named schema.",
                     type: "object",
                     properties: {
                         $ref: {
-                            description: "Reference to the named schema.\n\nThe `$ref` is a reference to a named schema. The format follows the\nJSON Pointer specification. In OpenAPI, the `$ref` starts with `#/$defs/`\nwhich indicates the type is stored in the\n{@link IChatGptSchema.IParameters.$defs} object.\n\n- `#/$defs/SomeObject`\n- `#/$defs/AnotherObject`",
+                            description: "Reference to the named schema.\n\nThe `$ref` is a reference to a named schema. The format follows the JSON\nPointer specification. In OpenAPI, the `$ref` starts with `#/$defs/`\nwhich indicates the type is stored in the\n{@link IChatGptSchema.IParameters.$defs} object.\n\n- `#/$defs/SomeObject`\n- `#/$defs/AnotherObject`",
                             type: "string"
                         },
                         title: {
@@ -2433,13 +2450,14 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "$ref" ]
                 },
                 "IChatGptSchema.IAnyOf": {
-                    description: 'Union type.\n\n`IAnyOf` represents a union type in TypeScript (`A | B | C`).\n\nFor reference, even if your Swagger (or OpenAPI) document defines\n`anyOf` instead of `oneOf`, {@link IChatGptSchema} forcibly converts it\nto `anyOf` type.\n\n### Description of {@link "x-discriminator"} property:\n\n> Discriminator info of the union type.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.',
+                    description: "Union type.\n\n`IAnyOf` represents a union type in TypeScript (`A | B | C`).\n\nFor reference, even if your Swagger (or OpenAPI) document defines `anyOf`\ninstead of `oneOf`, {@link IChatGptSchema} forcibly converts it to `anyOf`\ntype.",
                     type: "object",
                     properties: {
                         anyOf: {
@@ -2447,13 +2465,13 @@ const FUNCTION = {
                             type: "array",
                             items: {
                                 anyOf: [ {
-                                    $ref: "#/$defs/IChatGptSchema.IString"
-                                }, {
                                     $ref: "#/$defs/IChatGptSchema.INumber"
                                 }, {
                                     $ref: "#/$defs/IChatGptSchema.IInteger"
                                 }, {
                                     $ref: "#/$defs/IChatGptSchema.IBoolean"
+                                }, {
+                                    $ref: "#/$defs/IChatGptSchema.IString"
                                 }, {
                                     $ref: "#/$defs/IChatGptSchema.IArray"
                                 }, {
@@ -2468,6 +2486,7 @@ const FUNCTION = {
                             }
                         },
                         "x-discriminator": {
+                            description: "Discriminator info of the union type.",
                             $ref: "#/$defs/IChatGptSchema.IAnyOf.IDiscriminator"
                         },
                         title: {
@@ -2486,13 +2505,14 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "anyOf" ]
                 },
                 "IChatGptSchema.IUnknown": {
-                    description: "Unknown, the `any` type.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Unknown, the `any` type.",
                     type: "object",
                     properties: {
                         title: {
@@ -2511,13 +2531,14 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: []
                 },
                 "IChatGptSchema.INull": {
-                    description: "Null type.\n\n### Description of {@link examples} property:\n\n> List of example values as key-value pairs.",
+                    description: "Null type.",
                     type: "object",
                     properties: {
                         type: {
@@ -2541,13 +2562,14 @@ const FUNCTION = {
                             description: "Example value."
                         },
                         examples: {
+                            description: "List of example values as key-value pairs.",
                             $ref: "#/$defs/Recordstringany"
                         }
                     },
                     required: [ "type" ]
                 },
                 "IChatGptSchema.IAnyOf.IDiscriminator": {
-                    description: "Discriminator info of the union type.\n\n### Description of {@link mapping} property:\n\n> Mapping of discriminator values to schema names.\n> \n> This property is valid only for {@link IReference} typed\n> {@link IAnyOf.anyOf} elements. Therefore, the `key` of `mapping` is the\n> discriminator value, and the `value` of `mapping` is the schema name like\n> `#/components/schemas/SomeObject`.",
+                    description: "Discriminator info of the union type.",
                     type: "object",
                     properties: {
                         propertyName: {
@@ -2555,6 +2577,7 @@ const FUNCTION = {
                             type: "string"
                         },
                         mapping: {
+                            description: "Mapping of discriminator values to schema names.\n\nThis property is valid only for {@link IReference} typed\n{@link IAnyOf.anyOf} elements. Therefore, the `key` of `mapping` is the\ndiscriminator value, and the `value` of `mapping` is the schema name\nlike `#/components/schemas/SomeObject`.",
                             $ref: "#/$defs/Recordstringstring"
                         }
                     },
@@ -2570,10 +2593,11 @@ const FUNCTION = {
                     }
                 },
                 "IHttpLlmFunction.ISeparatedchatgpt": {
-                    description: "Collection of separated parameters.\n\n### Description of {@link llm} property:\n\n> Parameters that would be composed by the LLM.\n> \n> Even though no property exists in the LLM side, the `llm` property would\n> have at least empty object type.",
+                    description: "Collection of separated parameters.",
                     type: "object",
                     properties: {
                         llm: {
+                            description: "Parameters that would be composed by the LLM.\n\nEven though no property exists in the LLM side, the `llm` property would\nhave at least empty object type.",
                             $ref: "#/$defs/IChatGptSchema.IParameters"
                         },
                         human: {
@@ -3751,7 +3775,7 @@ function assertHttpController(props) {
         }));
         const _io199 = input => (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.options || "object" === typeof input.options && null !== input.options && false === Array.isArray(input.options) && _io200(input.options)) && (undefined === input.get || "object" === typeof input.get && null !== input.get && false === Array.isArray(input.get) && _io200(input.get)) && (undefined === input.post || "object" === typeof input.post && null !== input.post && false === Array.isArray(input.post) && _io200(input.post)) && (undefined === input.patch || "object" === typeof input.patch && null !== input.patch && false === Array.isArray(input.patch) && _io200(input.patch)) && (undefined === input.put || "object" === typeof input.put && null !== input.put && false === Array.isArray(input.put) && _io200(input.put)) && (undefined === input["delete"] || "object" === typeof input["delete"] && null !== input["delete"] && false === Array.isArray(input["delete"]) && _io200(input["delete"])) && (undefined === input.head || "object" === typeof input.head && null !== input.head && false === Array.isArray(input.head) && _io200(input.head)) && (undefined === input.trace || "object" === typeof input.trace && null !== input.trace && false === Array.isArray(input.trace) && _io200(input.trace));
         const _io200 = input => (undefined === input.operationId || "string" === typeof input.operationId) && (undefined === input.parameters || Array.isArray(input.parameters) && input.parameters.every((elem => "object" === typeof elem && null !== elem && _io201(elem)))) && (undefined === input.requestBody || "object" === typeof input.requestBody && null !== input.requestBody && false === Array.isArray(input.requestBody) && _io204(input.requestBody)) && (undefined === input.responses || "object" === typeof input.responses && null !== input.responses && false === Array.isArray(input.responses) && _io207(input.responses)) && (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.security || Array.isArray(input.security) && input.security.every((elem => "object" === typeof elem && null !== elem && false === Array.isArray(elem) && _io39(elem)))) && (undefined === input.tags || Array.isArray(input.tags) && input.tags.every((elem => "string" === typeof elem))) && (undefined === input.deprecated || "boolean" === typeof input.deprecated) && (undefined === input["x-samchon-human"] || "boolean" === typeof input["x-samchon-human"]) && (undefined === input["x-samchon-accessor"] || Array.isArray(input["x-samchon-accessor"]) && input["x-samchon-accessor"].every((elem => "string" === typeof elem))) && (undefined === input["x-samchon-controller"] || "string" === typeof input["x-samchon-controller"]);
-        const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.title || "string" === typeof input.title) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
+        const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
         const _io202 = input => Object.keys(input).every((key => {
             const value = input[key];
             if (undefined === value) return true;
@@ -12356,11 +12380,6 @@ function assertHttpController(props) {
             path: _path + ".required",
             expected: "(boolean | undefined)",
             value: input.required
-        }, _errorFactory)) && (undefined === input.title || "string" === typeof input.title || __typia_transform__assertGuard._assertGuard(_exceptionable, {
-            method: "typia.assert",
-            path: _path + ".title",
-            expected: "(string | undefined)",
-            value: input.title
         }, _errorFactory)) && (undefined === input.description || "string" === typeof input.description || __typia_transform__assertGuard._assertGuard(_exceptionable, {
             method: "typia.assert",
             path: _path + ".description",
@@ -13123,7 +13142,7 @@ function assertHttpLlmApplication(props) {
             }));
             const _io199 = input => (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.options || "object" === typeof input.options && null !== input.options && false === Array.isArray(input.options) && _io200(input.options)) && (undefined === input.get || "object" === typeof input.get && null !== input.get && false === Array.isArray(input.get) && _io200(input.get)) && (undefined === input.post || "object" === typeof input.post && null !== input.post && false === Array.isArray(input.post) && _io200(input.post)) && (undefined === input.patch || "object" === typeof input.patch && null !== input.patch && false === Array.isArray(input.patch) && _io200(input.patch)) && (undefined === input.put || "object" === typeof input.put && null !== input.put && false === Array.isArray(input.put) && _io200(input.put)) && (undefined === input["delete"] || "object" === typeof input["delete"] && null !== input["delete"] && false === Array.isArray(input["delete"]) && _io200(input["delete"])) && (undefined === input.head || "object" === typeof input.head && null !== input.head && false === Array.isArray(input.head) && _io200(input.head)) && (undefined === input.trace || "object" === typeof input.trace && null !== input.trace && false === Array.isArray(input.trace) && _io200(input.trace));
             const _io200 = input => (undefined === input.operationId || "string" === typeof input.operationId) && (undefined === input.parameters || Array.isArray(input.parameters) && input.parameters.every((elem => "object" === typeof elem && null !== elem && _io201(elem)))) && (undefined === input.requestBody || "object" === typeof input.requestBody && null !== input.requestBody && false === Array.isArray(input.requestBody) && _io204(input.requestBody)) && (undefined === input.responses || "object" === typeof input.responses && null !== input.responses && false === Array.isArray(input.responses) && _io207(input.responses)) && (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.security || Array.isArray(input.security) && input.security.every((elem => "object" === typeof elem && null !== elem && false === Array.isArray(elem) && _io39(elem)))) && (undefined === input.tags || Array.isArray(input.tags) && input.tags.every((elem => "string" === typeof elem))) && (undefined === input.deprecated || "boolean" === typeof input.deprecated) && (undefined === input["x-samchon-human"] || "boolean" === typeof input["x-samchon-human"]) && (undefined === input["x-samchon-accessor"] || Array.isArray(input["x-samchon-accessor"]) && input["x-samchon-accessor"].every((elem => "string" === typeof elem))) && (undefined === input["x-samchon-controller"] || "string" === typeof input["x-samchon-controller"]);
-            const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.title || "string" === typeof input.title) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
+            const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
             const _io202 = input => Object.keys(input).every((key => {
                 const value = input[key];
                 if (undefined === value) return true;
@@ -21728,11 +21747,6 @@ function assertHttpLlmApplication(props) {
                 path: _path + ".required",
                 expected: "(boolean | undefined)",
                 value: input.required
-            }, _errorFactory)) && (undefined === input.title || "string" === typeof input.title || __typia_transform__assertGuard._assertGuard(_exceptionable, {
-                method: "typia.assert",
-                path: _path + ".title",
-                expected: "(string | undefined)",
-                value: input.title
             }, _errorFactory)) && (undefined === input.description || "string" === typeof input.description || __typia_transform__assertGuard._assertGuard(_exceptionable, {
                 method: "typia.assert",
                 path: _path + ".description",
@@ -24090,7 +24104,7 @@ function validateHttpController(props) {
         }));
         const _io199 = input => (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.options || "object" === typeof input.options && null !== input.options && false === Array.isArray(input.options) && _io200(input.options)) && (undefined === input.get || "object" === typeof input.get && null !== input.get && false === Array.isArray(input.get) && _io200(input.get)) && (undefined === input.post || "object" === typeof input.post && null !== input.post && false === Array.isArray(input.post) && _io200(input.post)) && (undefined === input.patch || "object" === typeof input.patch && null !== input.patch && false === Array.isArray(input.patch) && _io200(input.patch)) && (undefined === input.put || "object" === typeof input.put && null !== input.put && false === Array.isArray(input.put) && _io200(input.put)) && (undefined === input["delete"] || "object" === typeof input["delete"] && null !== input["delete"] && false === Array.isArray(input["delete"]) && _io200(input["delete"])) && (undefined === input.head || "object" === typeof input.head && null !== input.head && false === Array.isArray(input.head) && _io200(input.head)) && (undefined === input.trace || "object" === typeof input.trace && null !== input.trace && false === Array.isArray(input.trace) && _io200(input.trace));
         const _io200 = input => (undefined === input.operationId || "string" === typeof input.operationId) && (undefined === input.parameters || Array.isArray(input.parameters) && input.parameters.every((elem => "object" === typeof elem && null !== elem && _io201(elem)))) && (undefined === input.requestBody || "object" === typeof input.requestBody && null !== input.requestBody && false === Array.isArray(input.requestBody) && _io204(input.requestBody)) && (undefined === input.responses || "object" === typeof input.responses && null !== input.responses && false === Array.isArray(input.responses) && _io207(input.responses)) && (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.security || Array.isArray(input.security) && input.security.every((elem => "object" === typeof elem && null !== elem && false === Array.isArray(elem) && _io39(elem)))) && (undefined === input.tags || Array.isArray(input.tags) && input.tags.every((elem => "string" === typeof elem))) && (undefined === input.deprecated || "boolean" === typeof input.deprecated) && (undefined === input["x-samchon-human"] || "boolean" === typeof input["x-samchon-human"]) && (undefined === input["x-samchon-accessor"] || Array.isArray(input["x-samchon-accessor"]) && input["x-samchon-accessor"].every((elem => "string" === typeof elem))) && (undefined === input["x-samchon-controller"] || "string" === typeof input["x-samchon-controller"]);
-        const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.title || "string" === typeof input.title) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
+        const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
         const _io202 = input => Object.keys(input).every((key => {
             const value = input[key];
             if (undefined === value) return true;
@@ -31069,10 +31083,6 @@ function validateHttpController(props) {
             path: _path + ".required",
             expected: "(boolean | undefined)",
             value: input.required
-        }), undefined === input.title || "string" === typeof input.title || _report(_exceptionable, {
-            path: _path + ".title",
-            expected: "(string | undefined)",
-            value: input.title
         }), undefined === input.description || "string" === typeof input.description || _report(_exceptionable, {
             path: _path + ".description",
             expected: "(string | undefined)",
@@ -31791,7 +31801,7 @@ function validateHttpLlmApplication(props) {
         }));
         const _io199 = input => (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.options || "object" === typeof input.options && null !== input.options && false === Array.isArray(input.options) && _io200(input.options)) && (undefined === input.get || "object" === typeof input.get && null !== input.get && false === Array.isArray(input.get) && _io200(input.get)) && (undefined === input.post || "object" === typeof input.post && null !== input.post && false === Array.isArray(input.post) && _io200(input.post)) && (undefined === input.patch || "object" === typeof input.patch && null !== input.patch && false === Array.isArray(input.patch) && _io200(input.patch)) && (undefined === input.put || "object" === typeof input.put && null !== input.put && false === Array.isArray(input.put) && _io200(input.put)) && (undefined === input["delete"] || "object" === typeof input["delete"] && null !== input["delete"] && false === Array.isArray(input["delete"]) && _io200(input["delete"])) && (undefined === input.head || "object" === typeof input.head && null !== input.head && false === Array.isArray(input.head) && _io200(input.head)) && (undefined === input.trace || "object" === typeof input.trace && null !== input.trace && false === Array.isArray(input.trace) && _io200(input.trace));
         const _io200 = input => (undefined === input.operationId || "string" === typeof input.operationId) && (undefined === input.parameters || Array.isArray(input.parameters) && input.parameters.every((elem => "object" === typeof elem && null !== elem && _io201(elem)))) && (undefined === input.requestBody || "object" === typeof input.requestBody && null !== input.requestBody && false === Array.isArray(input.requestBody) && _io204(input.requestBody)) && (undefined === input.responses || "object" === typeof input.responses && null !== input.responses && false === Array.isArray(input.responses) && _io207(input.responses)) && (undefined === input.servers || Array.isArray(input.servers) && input.servers.every((elem => "object" === typeof elem && null !== elem && _io167(elem)))) && (undefined === input.summary || "string" === typeof input.summary) && (undefined === input.description || "string" === typeof input.description) && (undefined === input.security || Array.isArray(input.security) && input.security.every((elem => "object" === typeof elem && null !== elem && false === Array.isArray(elem) && _io39(elem)))) && (undefined === input.tags || Array.isArray(input.tags) && input.tags.every((elem => "string" === typeof elem))) && (undefined === input.deprecated || "boolean" === typeof input.deprecated) && (undefined === input["x-samchon-human"] || "boolean" === typeof input["x-samchon-human"]) && (undefined === input["x-samchon-accessor"] || Array.isArray(input["x-samchon-accessor"]) && input["x-samchon-accessor"].every((elem => "string" === typeof elem))) && (undefined === input["x-samchon-controller"] || "string" === typeof input["x-samchon-controller"]);
-        const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.title || "string" === typeof input.title) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
+        const _io201 = input => (undefined === input.name || "string" === typeof input.name) && ("path" === input["in"] || "header" === input["in"] || "query" === input["in"] || "cookie" === input["in"]) && ("object" === typeof input.schema && null !== input.schema && false === Array.isArray(input.schema) && _iu7(input.schema)) && (undefined === input.required || "boolean" === typeof input.required) && (undefined === input.description || "string" === typeof input.description) && true && (undefined === input.examples || "object" === typeof input.examples && null !== input.examples && false === Array.isArray(input.examples) && _io202(input.examples));
         const _io202 = input => Object.keys(input).every((key => {
             const value = input[key];
             if (undefined === value) return true;
@@ -38770,10 +38780,6 @@ function validateHttpLlmApplication(props) {
             path: _path + ".required",
             expected: "(boolean | undefined)",
             value: input.required
-        }), undefined === input.title || "string" === typeof input.title || _report(_exceptionable, {
-            path: _path + ".title",
-            expected: "(string | undefined)",
-            value: input.title
         }), undefined === input.description || "string" === typeof input.description || _report(_exceptionable, {
             path: _path + ".description",
             expected: "(string | undefined)",