@agentica/core 0.34.2 → 0.35.0

package/lib/orchestrate/initialize.js

@@ -54,11 +54,11 @@ const events_1 = require("../factory/events");
 const histories_1 = require("../factory/histories");
 const ChatGptCompletionStreamingUtil_1 = require("../utils/ChatGptCompletionStreamingUtil");
 const FUNCTION = {
-    model: "chatgpt",
-    options: {
+    config: {
         reference: true,
         strict: false,
-        separate: null
+        separate: null,
+        validate: null
     },
     functions: [
         {
@@ -70,8 +70,8 @@ const FUNCTION = {
                 required: [],
                 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```",
+                    IHttpLlmFunction: {
+                        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 ILlmSchema}.\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: {
@@ -90,54 +90,55 @@ const FUNCTION = {
                                 type: "string"
                             },
                             name: {
-                                description: "Representative name of the function.\n\nThe `name` is a representative name identifying the function in the\n{@link IHttpLlmApplication}. The `name` value is just composed by joining\nthe {@link IHttpMigrateRoute.accessor} by underscore `_` character.\n\nHere is the composition rule of the {@link IHttpMigrateRoute.accessor}:\n\n> The `accessor` is composed with the following rules. At first, namespaces\n> are composed by static directory names in the {@link path}. Parametric\n> symbols represented by `:param` or `{param}` cannot be a part of the\n> namespace.\n\n> Instead, they would be a part of the function name. The function name is\n> composed with the {@link method HTTP method} and parametric symbols like\n> `getByParam` or `postByParam`. If there are multiple path parameters, they\n> would be concatenated by `And` like `getByParam1AndParam2`.\n\n> For reference, if the {@link operation}'s {@link method} is `delete`, the\n> function name would be replaced to `erase` instead of `delete`. It is the\n> reason why the `delete` is a reserved keyword in many programming\n> languages.\n\n> - Example 1\n\n>   - Path: `POST /shopping/sellers/sales`\n>   - Accessor: `shopping.sellers.sales.post`\n> - Example 2\n\n>   - Endpoint: `GET\n>       /shoppings/sellers/sales/:saleId/reviews/:reviewId/comments/:id`\n>   - Accessor:\n>       `shoppings.sellers.sales.reviews.getBySaleIdAndReviewIdAndCommentId`\n\n\n@maxLength 64",
-                                type: "string"
+                                description: "Representative name of the function.\n\nThe `name` is a representative name identifying the function in the\n{@link IHttpLlmApplication}. The `name` value is just composed by joining\nthe {@link IHttpMigrateRoute.accessor} by underscore `_` character.\n\nHere is the composition rule of the {@link IHttpMigrateRoute.accessor}:\n\n> The `accessor` is composed with the following rules. At first, namespaces\n> are composed by static directory names in the {@link path}. Parametric\n> symbols represented by `:param` or `{param}` cannot be a part of the\n> namespace.\n\n> Instead, they would be a part of the function name. The function name is\n> composed with the {@link method HTTP method} and parametric symbols like\n> `getByParam` or `postByParam`. If there are multiple path parameters, they\n> would be concatenated by `And` like `getByParam1AndParam2`.\n\n> For reference, if the {@link operation}'s {@link method} is `delete`, the\n> function name would be replaced to `erase` instead of `delete`. It is the\n> reason why the `delete` is a reserved keyword in many programming\n> languages.\n\n> - Example 1\n\n> - Path: `POST /shopping/sellers/sales`\n> - Accessor: `shopping.sellers.sales.post`\n> - Example 2\n\n> - Endpoint: `GET\n>   /shoppings/sellers/sales/:saleId/reviews/:reviewId/comments/:id`\n> - Accessor:\n>   `shoppings.sellers.sales.reviews.getBySaleIdAndReviewIdAndCommentId`",
+                                type: "string",
+                                maxLength: 64
                             },
                             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"
+                                description: "List of parameter types.\n\nIf you've configured {@link IHttpLlmApplication.IConfig.keyword} as `true`,\nnumber of {@link IHttpLlmFunction.parameters} are always 1 and the first\nparameter's type is always {@link ILlmSchema.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/ILlmSchema.IParameters"
                             },
                             separated: {
-                                description: "Collection of separated parameters.\n\nFilled only when {@link IHttpLlmApplication.IOptions.separate} is\nconfigured.",
-                                $ref: "#/$defs/IHttpLlmFunction.ISeparatedchatgpt"
+                                description: "Collection of separated parameters.\n\nFilled only when {@link IHttpLlmApplication.IConfig.separate} is configured.",
+                                $ref: "#/$defs/IHttpLlmFunction.ISeparated"
                             },
                             output: {
                                 description: "Expected return type.\n\nIf the target operation returns nothing (`void`), the `output` would be\n`undefined`.",
                                 anyOf: [
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.INumber"
+                                        $ref: "#/$defs/ILlmSchema.IBoolean"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IInteger"
+                                        $ref: "#/$defs/ILlmSchema.INumber"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IBoolean"
+                                        $ref: "#/$defs/ILlmSchema.IInteger"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IString"
+                                        $ref: "#/$defs/ILlmSchema.IString"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IArray"
+                                        $ref: "#/$defs/ILlmSchema.IArray"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IObject"
+                                        $ref: "#/$defs/ILlmSchema.IObject"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IReference"
+                                        $ref: "#/$defs/ILlmSchema.IReference"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IAnyOf"
+                                        $ref: "#/$defs/ILlmSchema.IAnyOf"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IUnknown"
+                                        $ref: "#/$defs/ILlmSchema.IUnknown"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.INull"
+                                        $ref: "#/$defs/ILlmSchema.INull"
                                     }
                                 ]
                             },
                             description: {
-                                description: "Description of the function.\n\n`IHttpLlmFunction.description` is composed using the following rules:\n\n1. Starts with the {@link OpenApi.IOperation.summary} paragraph\n2. The next paragraphs are filled with the\n   {@link OpenApi.IOperation.description}. If the first\n   paragraph of {@link OpenApi.IOperation.description} matches the\n   {@link OpenApi.IOperation.summary}, it is not duplicated\n3. Parameter descriptions are added with `@param` tags\n4. {@link OpenApi.IOperation.security Security requirements} are added with\n   `@security` tags\n5. Tag names are added with `@tag` tags\n6. If {@link OpenApi.IOperation.deprecated}, a `@deprecated` tag is added\n\nFor reference, the `description` is a critical property for teaching the\npurpose of the function to LLMs (Large Language Models). LLMs use this\ndescription to determine which function to call.\n\nAlso, when the LLM converses with users, the `description` explains the\nfunction to the user. Therefore, the `description` property has the\nhighest priority and should be carefully considered.",
+                                description: "Description of the function.\n\n`IHttpLlmFunction.description` is composed using the following rules:\n\n1. Starts with the {@link OpenApi.IOperation.summary} paragraph\n2. The next paragraphs are filled with the\n   {@link OpenApi.IOperation.description}. If the first paragraph of\n   {@link OpenApi.IOperation.description} matches the\n   {@link OpenApi.IOperation.summary}, it is not duplicated\n3. Parameter descriptions are added with `@param` tags\n4. {@link OpenApi.IOperation.security Security requirements} are added with\n   `@security` tags\n5. Tag names are added with `@tag` tags\n6. If {@link OpenApi.IOperation.deprecated}, a `@deprecated` tag is added\n\nFor reference, the `description` is a critical property for teaching the\npurpose of the function to LLMs (Large Language Models). LLMs use this\ndescription to determine which function to call.\n\nAlso, when the LLM converses with users, the `description` explains the\nfunction to the user. Therefore, the `description` property has the highest\npriority and should be carefully considered.",
                                 type: "string"
                             },
                             deprecated: {
@@ -159,13 +160,13 @@ const FUNCTION = {
                             "parameters"
                         ]
                     },
-                    "IChatGptSchema.IParameters": {
-                        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.",
+                    "ILlmSchema.IParameters": {
+                        description: "Type for function parameters.\n\n`ILlmSchema.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 LLM responses.",
                         type: "object",
                         properties: {
                             $defs: {
-                                description: "Collection of the named types.",
-                                $ref: "#/$defs/RecordstringIChatGptSchema"
+                                description: "Collection of the named types.\n\nThis record would be filled when {@link IConfig.reference} is `true`, or\nrecursive type comes.",
+                                $ref: "#/$defs/RecordstringILlmSchema"
                             },
                             additionalProperties: {
                                 description: "Additional properties information.\n\nThe `additionalProperties` defines the type schema for additional\nproperties that are not listed in the {@link properties}.\n\nBy the way, it is not allowed at the parameters level.",
@@ -183,7 +184,7 @@ const FUNCTION = {
                             },
                             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"
+                                $ref: "#/$defs/RecordstringILlmSchema"
                             },
                             required: {
                                 description: "List of required property keys.\n\nThe `required` contains a list of property keys from {@link properties}\nthat must be provided. Properties not listed in `required` are optional,\nwhile those listed must be filled.\n\nBelow is an example of {@link properties} and `required`:\n\n```typescript\ninterface SomeObject {\n  id: string;\n  email: string;\n  name?: string;\n}\n```\n\nAs you can see, `id` and `email` {@link properties} are {@link required},\nso they are listed in the `required` array.\n\n```json\n{\n  \"type\": \"object\",\n  \"properties\": {\n    \"id\": { \"type\": \"string\" },\n    \"email\": { \"type\": \"string\" },\n    \"name\": { \"type\": \"string\" }\n  },\n  \"required\": [\"id\", \"email\"]\n}\n```",
@@ -210,6 +211,14 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
@@ -220,51 +229,51 @@ const FUNCTION = {
                             "required"
                         ]
                     },
-                    RecordstringIChatGptSchema: {
+                    RecordstringILlmSchema: {
                         description: "Construct a type with a set of properties K of type T",
                         type: "object",
                         properties: {},
                         required: [],
                         additionalProperties: {
-                            $ref: "#/$defs/IChatGptSchema"
+                            $ref: "#/$defs/ILlmSchema"
                         }
                     },
-                    IChatGptSchema: {
-                        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```",
+                    ILlmSchema: {
+                        description: "Type schema info for LLM (Large Language Model) function calling.\n\n## Overview\n\n`ILlmSchema` is a type schema info for LLM function calling, designed to be\ncompatible with multiple LLM providers while following the JSON schema\nspecification.\n\n## Specification\n\n`ILlmSchema` basically follows the JSON schema definition of the OpenAPI v3.1\nspecification; {@link OpenApiV3_1.IJsonSchema}.\n\nHowever, it deviates from the standard JSON schema specification and omits\nmany features to ensure compatibility across different LLM providers and\ntheir function calling requirements.\n\n## Differences from OpenAPI v3.1\n\nHere is the list of how `ILlmSchema` is different with the OpenAPI v3.1 JSON\nschema:\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 ILlmSchema.IAnyOf}\n- Merge {@link OpenApiV3_1.IJsonSchema.IAllOf} to {@link ILlmSchema.IObject}\n- Merge {@link OpenApiV3_1.IJsonSchema.IRecursiveReference} to\n  {@link ILlmSchema.IReference}\n\n## Differences from OpenApi.IJsonSchema\n\nCompared to {@link OpenApi.IJsonSchema}, the emended JSON schema\nspecification:\n\n- {@link ILlmSchema.IAnyOf} instead of {@link OpenApi.IJsonSchema.IOneOf}\n- {@link ILlmSchema.IParameters.$defs} instead of\n  {@link OpenApi.IJsonSchema.IComponents.schemas}\n- Do not support {@link OpenApi.IJsonSchema.ITuple} type\n- {@link ILlmSchema.properties} and {@link ILlmSchema.required} are always\n  defined\n\n## Strict Mode\n\nWhen {@link ILlmSchema.IConfig.strict} mode is enabled, the schema\ntransformation follows OpenAI's structured output requirements:\n\n- Every {@link ILlmSchema.IObject.additionalProperties} is forced to `false`\n- Every property in {@link ILlmSchema.IObject.properties} becomes\n  {@link ILlmSchema.IObject.required}\n- All constraint properties are removed from the schema and moved to\n  {@link IJsonSchemaAttribute.description} in a JSDoc-like format:\n\n  - Numeric constraints: `minimum`, `maximum`, `exclusiveMinimum`,\n      `exclusiveMaximum`, `multipleOf`\n  - String constraints: `minLength`, `maxLength`, `pattern`, `format`,\n      `contentMediaType`\n  - Array constraints: `minItems`, `maxItems`, `uniqueItems`\n  - Example: `@minimum 0`, `@maximum 100`, `@format uuid`",
                         anyOf: [
                             {
-                                $ref: "#/$defs/IChatGptSchema.IBoolean"
+                                $ref: "#/$defs/ILlmSchema.IBoolean"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IInteger"
+                                $ref: "#/$defs/ILlmSchema.IInteger"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.INumber"
+                                $ref: "#/$defs/ILlmSchema.INumber"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IString"
+                                $ref: "#/$defs/ILlmSchema.IString"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IArray"
+                                $ref: "#/$defs/ILlmSchema.IArray"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IObject"
+                                $ref: "#/$defs/ILlmSchema.IObject"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IReference"
+                                $ref: "#/$defs/ILlmSchema.IReference"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IAnyOf"
+                                $ref: "#/$defs/ILlmSchema.IAnyOf"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.INull"
+                                $ref: "#/$defs/ILlmSchema.INull"
                             },
                             {
-                                $ref: "#/$defs/IChatGptSchema.IUnknown"
+                                $ref: "#/$defs/ILlmSchema.IUnknown"
                             }
                         ]
                     },
-                    "IChatGptSchema.IBoolean": {
+                    "ILlmSchema.IBoolean": {
                         description: "Boolean type info.",
                         type: "object",
                         properties: {
@@ -275,6 +284,10 @@ const FUNCTION = {
                                     type: "boolean"
                                 }
                             },
+                            "default": {
+                                description: "Default value.",
+                                type: "boolean"
+                            },
                             type: {
                                 description: "Discriminator value of the type.",
                                 type: "string",
@@ -300,6 +313,14 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
@@ -313,7 +334,7 @@ const FUNCTION = {
                         required: [],
                         additionalProperties: {}
                     },
-                    "IChatGptSchema.IInteger": {
+                    "ILlmSchema.IInteger": {
                         description: "Integer type info.",
                         type: "object",
                         properties: {
@@ -324,6 +345,31 @@ const FUNCTION = {
                                     type: "number"
                                 }
                             },
+                            "default": {
+                                description: "Default value.",
+                                type: "integer"
+                            },
+                            minimum: {
+                                description: "Minimum value restriction.",
+                                type: "integer"
+                            },
+                            maximum: {
+                                description: "Maximum value restriction.",
+                                type: "integer"
+                            },
+                            exclusiveMinimum: {
+                                description: "Exclusive minimum value restriction.",
+                                type: "integer"
+                            },
+                            exclusiveMaximum: {
+                                description: "Exclusive maximum value restriction.",
+                                type: "integer"
+                            },
+                            multipleOf: {
+                                description: "Multiple of value restriction.",
+                                type: "integer",
+                                exclusiveMinimum: 0
+                            },
                             type: {
                                 description: "Discriminator value of the type.",
                                 type: "string",
@@ -349,13 +395,21 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
                             "type"
                         ]
                     },
-                    "IChatGptSchema.INumber": {
+                    "ILlmSchema.INumber": {
                         description: "Number (double) type info.",
                         type: "object",
                         properties: {
@@ -366,6 +420,31 @@ const FUNCTION = {
                                     type: "number"
                                 }
                             },
+                            "default": {
+                                description: "Default value.",
+                                type: "number"
+                            },
+                            minimum: {
+                                description: "Minimum value restriction.",
+                                type: "number"
+                            },
+                            maximum: {
+                                description: "Maximum value restriction.",
+                                type: "number"
+                            },
+                            exclusiveMinimum: {
+                                description: "Exclusive minimum value restriction.",
+                                type: "number"
+                            },
+                            exclusiveMaximum: {
+                                description: "Exclusive maximum value restriction.",
+                                type: "number"
+                            },
+                            multipleOf: {
+                                description: "Multiple of value restriction.",
+                                type: "number",
+                                exclusiveMinimum: 0
+                            },
                             type: {
                                 description: "Discriminator value of the type.",
                                 type: "string",
@@ -391,13 +470,21 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
                             "type"
                         ]
                     },
-                    "IChatGptSchema.IString": {
+                    "ILlmSchema.IString": {
                         description: "String type info.",
                         type: "object",
                         properties: {
@@ -412,6 +499,28 @@ const FUNCTION = {
                                 description: "Default value.",
                                 type: "string"
                             },
+                            format: {
+                                description: "Format restriction.",
+                                type: "string"
+                            },
+                            pattern: {
+                                description: "Pattern restriction.",
+                                type: "string"
+                            },
+                            contentMediaType: {
+                                description: "Content media type restriction.",
+                                type: "string"
+                            },
+                            minLength: {
+                                description: "Minimum length restriction.",
+                                type: "integer",
+                                minimum: 0
+                            },
+                            maxLength: {
+                                description: "Maximum length restriction.",
+                                type: "integer",
+                                minimum: 0
+                            },
                             type: {
                                 description: "Discriminator value of the type.",
                                 type: "string",
@@ -437,19 +546,41 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
                             "type"
                         ]
                     },
-                    "IChatGptSchema.IArray": {
+                    "ILlmSchema.IArray": {
                         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"
+                                $ref: "#/$defs/ILlmSchema"
+                            },
+                            uniqueItems: {
+                                description: "Unique items restriction.\n\nIf this property value is `true`, target array must have unique items.",
+                                type: "boolean"
+                            },
+                            minItems: {
+                                description: "Minimum items restriction.\n\nRestriction of minimum number of items in the array.",
+                                type: "integer",
+                                minimum: 0
+                            },
+                            maxItems: {
+                                description: "Maximum items restriction.\n\nRestriction of maximum number of items in the array.",
+                                type: "integer",
+                                minimum: 0
                             },
                             type: {
                                 description: "Discriminator value of the type.",
@@ -476,6 +607,14 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
@@ -483,49 +622,49 @@ const FUNCTION = {
                             "type"
                         ]
                     },
-                    "IChatGptSchema.IObject": {
+                    "ILlmSchema.IObject": {
                         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"
+                                $ref: "#/$defs/RecordstringILlmSchema"
                             },
                             additionalProperties: {
-                                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`.",
+                                description: "Additional properties' info.\n\nThe `additionalProperties` means the type schema info of the 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 ILlmSchema} type, it means that the additional properties must\nfollow the type schema info.\n\n- `true`: `Record<string, any>`\n- `ILlmSchema`: `Record<string, T>`\n\nNote: When {@link IConfig.strict} mode is enabled, this property is always\nfixed to `false`, meaning no additional properties are allowed.",
                                 anyOf: [
                                     {
                                         type: "boolean"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.INumber"
+                                        $ref: "#/$defs/ILlmSchema.IBoolean"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IInteger"
+                                        $ref: "#/$defs/ILlmSchema.INumber"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IBoolean"
+                                        $ref: "#/$defs/ILlmSchema.IInteger"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IString"
+                                        $ref: "#/$defs/ILlmSchema.IString"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IArray"
+                                        $ref: "#/$defs/ILlmSchema.IArray"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IObject"
+                                        $ref: "#/$defs/ILlmSchema.IObject"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IReference"
+                                        $ref: "#/$defs/ILlmSchema.IReference"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IAnyOf"
+                                        $ref: "#/$defs/ILlmSchema.IAnyOf"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IUnknown"
+                                        $ref: "#/$defs/ILlmSchema.IUnknown"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.INull"
+                                        $ref: "#/$defs/ILlmSchema.INull"
                                     }
                                 ]
                             },
@@ -561,6 +700,14 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
@@ -569,12 +716,12 @@ const FUNCTION = {
                             "type"
                         ]
                     },
-                    "IChatGptSchema.IReference": {
-                        description: "Reference type directing to named schema.",
+                    "ILlmSchema.IReference": {
+                        description: "Reference type directing to named schema.\n\nIf {@link IConfig.strict} mode is enabled, its other properties like\n{@link description} would be disabled. Instead, the description would be\nplaced in the parent type. For example, if this reference type is used as a\nproperty of an object, the description would be placed in the object\nplace.",
                         type: "object",
                         properties: {
                             $ref: {
-                                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`",
+                                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 ILlmSchema.IParameters.$defs} object.\n\n- `#/$defs/SomeObject`\n- `#/$defs/AnotherObject`",
                                 type: "string"
                             },
                             title: {
@@ -595,14 +742,22 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         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 `anyOf`\ninstead of `oneOf`, {@link IChatGptSchema} forcibly converts it to `anyOf`\ntype.",
+                    "ILlmSchema.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 `oneOf`\ninstead of `anyOf`, {@link ILlmSchema} forcibly converts it to the\n`anyOf`-based {@link ILlmSchema.IAnyOf} type.",
                         type: "object",
                         properties: {
                             anyOf: {
@@ -611,38 +766,38 @@ const FUNCTION = {
                                 items: {
                                     anyOf: [
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.INumber"
+                                            $ref: "#/$defs/ILlmSchema.IBoolean"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IInteger"
+                                            $ref: "#/$defs/ILlmSchema.INumber"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IBoolean"
+                                            $ref: "#/$defs/ILlmSchema.IInteger"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IString"
+                                            $ref: "#/$defs/ILlmSchema.IString"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IArray"
+                                            $ref: "#/$defs/ILlmSchema.IArray"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IObject"
+                                            $ref: "#/$defs/ILlmSchema.IObject"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IReference"
+                                            $ref: "#/$defs/ILlmSchema.IReference"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.IUnknown"
+                                            $ref: "#/$defs/ILlmSchema.IUnknown"
                                         },
                                         {
-                                            $ref: "#/$defs/IChatGptSchema.INull"
+                                            $ref: "#/$defs/ILlmSchema.INull"
                                         }
                                     ]
                                 }
                             },
                             "x-discriminator": {
-                                description: "Discriminator info of the union type.",
-                                $ref: "#/$defs/IChatGptSchema.IAnyOf.IDiscriminator"
+                                description: "Discriminator info of the union type.\n\nThis discriminator is used to determine which type in the union should be\nused based on the value of a specific property.",
+                                $ref: "#/$defs/ILlmSchema.IAnyOf.IDiscriminator"
                             },
                             title: {
                                 description: "Title of the schema.",
@@ -662,13 +817,21 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
                             "anyOf"
                         ]
                     },
-                    "IChatGptSchema.IUnknown": {
+                    "ILlmSchema.IUnknown": {
                         description: "Unknown, the `any` type.",
                         type: "object",
                         properties: {
@@ -690,11 +853,19 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: []
                     },
-                    "IChatGptSchema.INull": {
+                    "ILlmSchema.INull": {
                         description: "Null type.",
                         type: "object",
                         properties: {
@@ -723,13 +894,21 @@ const FUNCTION = {
                             examples: {
                                 description: "List of example values as key-value pairs.",
                                 $ref: "#/$defs/Recordstringany"
+                            },
+                            readOnly: {
+                                description: "Whether the property is read-only.",
+                                type: "boolean"
+                            },
+                            writeOnly: {
+                                description: "Whether the property is write-only.",
+                                type: "boolean"
                             }
                         },
                         required: [
                             "type"
                         ]
                     },
-                    "IChatGptSchema.IAnyOf.IDiscriminator": {
+                    "ILlmSchema.IAnyOf.IDiscriminator": {
                         description: "Discriminator info of the union type.",
                         type: "object",
                         properties: {
@@ -755,13 +934,13 @@ const FUNCTION = {
                             type: "string"
                         }
                     },
-                    "IHttpLlmFunction.ISeparatedchatgpt": {
+                    "IHttpLlmFunction.ISeparated": {
                         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"
+                                $ref: "#/$defs/ILlmSchema.IParameters"
                             },
                             human: {
                                 description: "Parameters that would be composed by the human.",
@@ -770,7 +949,7 @@ const FUNCTION = {
                                         type: "null"
                                     },
                                     {
-                                        $ref: "#/$defs/IChatGptSchema.IParameters"
+                                        $ref: "#/$defs/ILlmSchema.IParameters"
                                     }
                                 ]
                             }
@@ -785,7 +964,7 @@ const FUNCTION = {
             output: {
                 type: "array",
                 items: {
-                    $ref: "#/$defs/IHttpLlmFunctionchatgpt"
+                    $ref: "#/$defs/IHttpLlmFunction"
                 }
             },
             description: "Get list of API functions.\n\nIf user seems like to request some function calling except this one,\ncall this `getApiFunctions()` to get the list of candidate API functions\nprovided from this application.\n\nAlso, user just wants to list up every remote API functions that can be\ncalled from the backend server, utilize this function too.",