@samchon/openapi/lib/structures/IMcpLlmApplication.d.mts

OpenAPI definitions and converters for 'typia' and 'nestia'.

import { ILlmSchema } from "./ILlmSchema";
import { IMcpLlmFunction } from "./IMcpLlmFunction";
/**
 * Application of LLM function call from MCP document.
 *
 * `IMcpLlmApplication` is an interface representing a collection of
 * {@link IMcpLlmFunction LLM function calling schemas} composed from the
 * MCP (Model Context Protocol) document. It contains
 * {@link IMcpLlmApplication.errors failed functions}, and adjusted
 * {@link IMcpLlmApplication.options options} during the `IMcpLlmApplication`
 * construction.
 *
 * About each function of MCP server, there can be {@link errors} during
 * the composition, if the target {@link model} does not support the
 * function's {@link IMcpLlmFunction.parameters} type. For example,
 * Google Gemini model does not support union type, so that the function
 * containing the union type would be placed into the {@link errors} list
 * instead of {@link functions}.
 *
 * Also, each function has its own {@link IMcpLlmFunction.validate}
 * function for correcting AI agent's mistakes, and this is the reason why
 * `@samchon/openapi` recommends not to use the
 * [`mcp_servers`](https://openai.github.io/openai-agents-python/mcp/#using-mcp-servers)
 * property of LLM API directly, but to use the function calling feature
 * instead.
 *
 * @author Jeongho Nam - https://github.com/samchon
 * @author Byeongjin Oh - https://github.com/sunrabbit123
 */
export interface IMcpLlmApplication<Model extends ILlmSchema.Model> {
    /**
     * Model of the target LLM.
     */
    model: Model;
    /**
     * List of function metadata.
     *
     * List of function metadata that can be used for the LLM function call.
     */
    functions: IMcpLlmFunction<Model>[];
    /**
     * List of errors occurred during the composition.
     */
    errors: IMcpLlmApplication.IError[];
    /**
     * Configuration for the application.
     */
    options: IMcpLlmApplication.IOptions<Model>;
}
export declare namespace IMcpLlmApplication {
    /**
     * Options for the HTTP LLM application schema composition.
     */
    type IOptions<Model extends ILlmSchema.Model> = ILlmSchema.ModelConfig[Model] & {
        /**
         * Maximum length of function name.
         *
         * When a function name is longer than this value, it will be truncated.
         *
         * If not possible to truncate due to the duplication, the function name
         * would be modified to randomly generated (UUID v4).
         *
         * @default 64
         */
        maxLength?: number;
    };
    /**
     * Error occurred in the composition.
     */
    interface IError {
        /**
         * Name of the failed function.
         */
        name: string;
        /**
         * Description of the failed function.
         */
        description?: string | undefined;
        /**
         * Parameters of the function.
         */
        parameters: object;
        /**
         * Error messages.
         *
         * The reason why the function is failed to be convert.
         */
        messages: string[];
    }
}