import { OpenApi } from "../openapi/OpenApi";
import { ILlmSchema } from "../schema/ILlmSchema";
import { IHttpLlmFunction } from "./IHttpLlmFunction";
import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
/**
 * LLM function calling application from OpenAPI document.
 *
 * `IHttpLlmApplication` is a collection of {@link IHttpLlmFunction} schemas
 * converted from {@link OpenApi.IDocument} by `HttpLlm.application()`. Each
 * OpenAPI operation becomes an LLM-callable function.
 *
 * Successful conversions go to {@link functions}, failed ones to {@link errors}
 * with detailed error messages. Common failure causes:
 *
 * - Unsupported schema features (tuples, `oneOf` with incompatible types)
 * - Missing required fields in OpenAPI document
 * - Operations marked with `x-samchon-human: true`
 *
 * Configure behavior via {@link IHttpLlmApplication.IConfig}:
 *
 * - {@link IHttpLlmApplication.IConfig.maxLength}: Function name length limit
 * - {@link ILlmSchema.IConfig.strict}: OpenAI structured output mode
 *
 * @author Jeongho Nam - https://github.com/samchon
 */
export interface IHttpLlmApplication {
    /** Successfully converted LLM function schemas. */
    functions: IHttpLlmFunction[];
    /** Operations that failed conversion. */
    errors: IHttpLlmApplication.IError[];
    /** Configuration used for composition. */
    config: IHttpLlmApplication.IConfig;
}
export declare namespace IHttpLlmApplication {
    /** Configuration for HTTP LLM application composition. */
    interface IConfig extends ILlmSchema.IConfig {
        /**
         * Maximum function name length. Truncated or UUID if exceeded.
         *
         * @default 64
         */
        maxLength: number;
        /**
         * Whether to disallow superfluous properties.
         *
         * @default false
         */
        equals: boolean;
    }
    /** Composition error for an operation. */
    interface IError {
        /** HTTP method of the failed operation. */
        method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
        /** Path of the failed operation. */
        path: string;
        /** Error messages describing the failure. */
        messages: string[];
        /** Returns source {@link OpenApi.IOperation}. */
        operation: () => OpenApi.IOperation;
        /** Returns source route. Undefined if error occurred at migration level. */
        route: () => IHttpMigrateRoute | undefined;
    }
}