@typia/utils 12.0.2 → 13.0.0-dev.20260425

package/lib/http/internal/HttpLlmApplicationComposer.mjs

@@ -1,304 +1,8 @@
-import { LlmSchemaConverter } from '../../converters/LlmSchemaConverter.mjs';
-import '../../utils/ArrayUtil.mjs';
-import { LlmJson } from '../../utils/LlmJson.mjs';
-import '../../utils/MapUtil.mjs';
-import '../../utils/NamingConvention.mjs';
-import '../../utils/StringUtil.mjs';
-import { OpenApiValidator } from '../../validators/OpenApiValidator.mjs';
+import { getDefaultExportFromCjs } from '../../_virtual/_commonjsHelpers.mjs';
+import { __require as requireHttpLlmApplicationComposer } from './HttpLlmApplicationComposer2.mjs';
 
-/**
- * Composes {@link IHttpLlmApplication} from an {@link IHttpMigrateApplication}.
- *
- * Converts OpenAPI-migrated HTTP routes into LLM function calling schemas,
- * filtering out unsupported methods (HEAD) and content types
- * (multipart/form-data), and shortening function names to fit the configured
- * maximum length.
- */
-var HttpLlmApplicationComposer;
-(function (HttpLlmApplicationComposer) {
-    /**
-     * Builds an {@link IHttpLlmApplication} from migrated HTTP routes.
-     *
-     * Iterates all routes, converts each to an {@link IHttpLlmFunction}, and
-     * collects conversion errors. Applies function name shortening at the end.
-     */
-    HttpLlmApplicationComposer.application = (props) => {
-        // fill in config defaults
-        const config = {
-            maxLength: props.config?.maxLength ?? 64,
-            equals: props.config?.equals ?? false,
-            strict: props.config?.strict ?? false,
-        };
-        // seed with pre-existing migration errors, excluding human-only endpoints
-        const errors = props.migrate.errors
-            .filter((e) => e.operation()["x-samchon-human"] !== true)
-            .map((e) => ({
-            method: e.method,
-            path: e.path,
-            messages: e.messages,
-            operation: () => e.operation(),
-            route: () => undefined,
-        }));
-        // convert each route to an LLM function, rejecting unsupported ones
-        const functions = props.migrate.routes
-            .filter((e) => e.operation()["x-samchon-human"] !== true)
-            .map((route, i) => {
-            // reject HEAD — LLMs cannot interpret header-only responses
-            if (route.method === "head") {
-                errors.push({
-                    method: route.method,
-                    path: route.path,
-                    messages: ["HEAD method is not supported in the LLM application."],
-                    operation: () => route.operation(),
-                    route: () => route,
-                });
-                return null;
-                // reject multipart/form-data — binary uploads not expressible in JSON Schema
-            }
-            else if (route.body?.type === "multipart/form-data" ||
-                route.success?.type === "multipart/form-data") {
-                errors.push({
-                    method: route.method,
-                    path: route.path,
-                    messages: [
-                        `The "multipart/form-data" content type is not supported in the LLM application.`,
-                    ],
-                    operation: () => route.operation(),
-                    route: () => route,
-                });
-                return null;
-            }
-            const localErrors = [];
-            const func = composeFunction({
-                components: props.migrate.document().components,
-                config,
-                route,
-                errors: localErrors});
-            if (func === null)
-                errors.push({
-                    method: route.method,
-                    path: route.path,
-                    messages: localErrors,
-                    operation: () => route.operation(),
-                    route: () => route,
-                });
-            return func;
-        })
-            .filter((v) => v !== null);
-        const app = {
-            config,
-            functions,
-            errors,
-        };
-        HttpLlmApplicationComposer.shorten(app, props.config?.maxLength ?? 64);
-        return app;
-    };
-    /**
-     * Converts a single {@link IHttpMigrateRoute} into an {@link IHttpLlmFunction}
-     * by composing parameter/output schemas and validating function name
-     * constraints.
-     */
-    const composeFunction = (props) => {
-        // accessor prefix for error messages (mirrors OpenAPI document structure)
-        const endpoint = `$input.paths[${JSON.stringify(props.route.path)}][${JSON.stringify(props.route.method)}]`;
-        const operation = props.route.operation();
-        const description = concatDescription({
-            summary: operation.summary,
-            description: operation.description,
-        });
-        if ((description?.length ?? 0) > 1_024) {
-            props.errors.push(`The description of the function is too long (must be equal or less than 1,024 characters, but ${description.length.toLocaleString()} length).`);
-        }
-        // build function name from route accessor, replacing forbidden chars
-        const name = emend(props.route.accessor.join("_"));
-        const isNameVariable = /^[a-zA-Z0-9_-]+$/.test(name);
-        const isNameStartsWithNumber = /^[0-9]/.test(name[0] ?? "");
-        if (isNameVariable === false)
-            props.errors.push(`Elements of path (separated by '/') must be composed with alphabets, numbers, underscores, and hyphens`);
-        if (isNameStartsWithNumber === true)
-            props.errors.push(`Function name cannot start with a number.`);
-        //----
-        // CONSTRUCT SCHEMAS
-        //----
-        // merge path parameters, query, and body into a single object schema
-        const parameters = {
-            type: "object",
-            properties: Object.fromEntries([
-                // path parameters (e.g., /users/:id)
-                ...props.route.parameters.map((s) => [
-                    s.key,
-                    {
-                        ...s.schema,
-                        description: s.parameter().description ?? s.schema.description,
-                    },
-                ]),
-                // query parameters
-                ...(props.route.query
-                    ? [
-                        [
-                            props.route.query.key,
-                            {
-                                ...props.route.query.schema,
-                                title: props.route.query.title() ?? props.route.query.schema.title,
-                                description: props.route.query.description() ??
-                                    props.route.query.schema.description,
-                            },
-                        ],
-                    ]
-                    : []),
-                // request body
-                ...(props.route.body
-                    ? [
-                        [
-                            props.route.body.key,
-                            {
-                                ...props.route.body.schema,
-                                description: props.route.body.description() ??
-                                    props.route.body.schema.description,
-                            },
-                        ],
-                    ]
-                    : []),
-            ]),
-        };
-        parameters.required = Object.keys(parameters.properties ?? {});
-        // convert merged object schema to LLM parameters
-        const llmParameters = LlmSchemaConverter.parameters({
-            config: props.config,
-            components: props.components,
-            schema: parameters,
-            accessor: `${endpoint}.parameters`,
-        });
-        // convert response schema to LLM output parameters
-        const output = props.route.success
-            ? LlmSchemaConverter.parameters({
-                config: props.config,
-                components: props.components,
-                schema: props.route.success.schema,
-                accessor: `${endpoint}.responses[${JSON.stringify(props.route.success.status)}][${JSON.stringify(props.route.success.type)}].schema`,
-            })
-            : undefined;
-        //----
-        // CONVERSION
-        //----
-        // bail out if any validation or conversion failed
-        if (output?.success === false ||
-            llmParameters.success === false ||
-            isNameVariable === false ||
-            isNameStartsWithNumber === true ||
-            (description?.length ?? 0) > 1_024) {
-            if (output?.success === false)
-                props.errors.push(...output.error.reasons.map((r) => `${r.accessor}: ${r.message}`));
-            if (llmParameters.success === false)
-                props.errors.push(
-                // rewrite internal accessor to match OpenAPI requestBody path
-                ...llmParameters.error.reasons.map((r) => {
-                    const accessor = r.accessor.replace(`parameters.properties["body"]`, `requestBody.content[${JSON.stringify(props.route.body?.type ?? "application/json")}].schema`);
-                    return `${accessor}: ${r.message}`;
-                }));
-            return null;
-        }
-        // assemble the LLM function
-        return {
-            method: props.route.method,
-            path: props.route.path,
-            name,
-            parameters: llmParameters.value,
-            output: output?.value,
-            description,
-            deprecated: operation.deprecated,
-            tags: operation.tags,
-            parse: (input) => LlmJson.parse(input, llmParameters.value),
-            coerce: (input) => LlmJson.coerce(input, llmParameters.value),
-            validate: OpenApiValidator.create({
-                components: props.components,
-                schema: parameters,
-                required: true,
-                equals: props.config.equals ?? false,
-            }),
-            route: () => props.route,
-            operation: () => props.route.operation(),
-        };
-    };
-    /**
-     * Shortens function names exceeding the character limit.
-     *
-     * Tries progressively shorter accessor suffixes first, then falls back to
-     * index-prefixed names, and finally UUID as a last resort.
-     */
-    HttpLlmApplicationComposer.shorten = (app, limit = 64) => {
-        // collect all names for uniqueness checks
-        const dictionary = new Set();
-        const longFunctions = [];
-        for (const func of app.functions) {
-            dictionary.add(func.name);
-            if (func.name.length > limit) {
-                longFunctions.push(func);
-            }
-        }
-        if (longFunctions.length === 0)
-            return;
-        let index = 0;
-        for (const func of longFunctions) {
-            let success = false;
-            const rename = (str) => {
-                dictionary.delete(func.name);
-                dictionary.add(str);
-                func.name = str;
-                success = true;
-            };
-            // try dropping leading accessor segments to shorten the name
-            // (e.g., "api_users_getById" → "users_getById" → "getById")
-            for (let i = 1; i < func.route().accessor.length; ++i) {
-                const shortName = func.route().accessor.slice(i).join("_");
-                if (shortName.length > limit - 8)
-                    continue; // reserve room for "_N_" prefix
-                else if (dictionary.has(shortName) === false)
-                    rename(shortName);
-                else {
-                    // name collision — prefix with a counter to disambiguate
-                    const newName = `_${index}_${shortName}`;
-                    if (dictionary.has(newName) === true)
-                        continue;
-                    rename(newName);
-                    ++index;
-                }
-                break;
-            }
-            // last resort — all suffix attempts failed or collided
-            if (success === false)
-                rename(randomFormatUuid());
-        }
-    };
-})(HttpLlmApplicationComposer || (HttpLlmApplicationComposer = {}));
-const randomFormatUuid = () => "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-    const r = (Math.random() * 16) | 0;
-    const v = c === "x" ? r : (r & 0x3) | 0x8;
-    return v.toString(16);
-});
-/** Replaces forbidden characters (`$`, `%`, `.`) with underscores. */
-const emend = (str) => {
-    for (const ch of FORBIDDEN)
-        str = str.split(ch).join("_");
-    return str;
-};
-const FORBIDDEN = ["$", "%", "."];
-/**
- * Concatenates summary and description into a single string.
- *
- * If both are present, joins them with a period and double newline, avoiding
- * duplication when the description already starts with the summary.
- */
-const concatDescription = (p) => {
-    if (!p.summary?.length || !p.description?.length)
-        return p.summary || p.description;
-    const summary = p.summary.endsWith(".")
-        ? p.summary.slice(0, -1)
-        : p.summary;
-    return p.description.startsWith(summary)
-        ? p.description
-        : summary + ".\n\n" + p.description;
-};
+var HttpLlmApplicationComposerExports = requireHttpLlmApplicationComposer();
+var HttpLlmApplicationComposer = /*@__PURE__*/getDefaultExportFromCjs(HttpLlmApplicationComposerExports);
 
-export { HttpLlmApplicationComposer };
+export { HttpLlmApplicationComposer as default };
 //# sourceMappingURL=HttpLlmApplicationComposer.mjs.map

package/lib/http/internal/HttpLlmApplicationComposer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"HttpLlmApplicationComposer.mjs","sources":["../../../src/http/internal/HttpLlmApplicationComposer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"HttpLlmApplicationComposer.mjs","sources":["HttpLlmApplicationComposer.js?commonjs-entry"],"sourcesContent":["import { getDefaultExportFromCjs } from \"\u0000commonjsHelpers.js\";\nimport { __require as requireHttpLlmApplicationComposer } from \"/home/samchon/github/samchon/typia@next/packages/utils/lib/http/internal/HttpLlmApplicationComposer.js\";\nvar HttpLlmApplicationComposerExports = requireHttpLlmApplicationComposer();\nexport { HttpLlmApplicationComposerExports as __moduleExports };\nexport default /*@__PURE__*/getDefaultExportFromCjs(HttpLlmApplicationComposerExports);"],"names":[],"mappings":";;;AAEA,IAAI,iCAAiC,GAAG,iCAAiC,EAAE;AAE3E,iCAAe,aAAa,uBAAuB,CAAC,iCAAiC,CAAC;;;;"}

package/lib/http/internal/HttpLlmApplicationComposer2.mjs

@@ -0,0 +1,309 @@
+import { __exports as HttpLlmApplicationComposer } from '../../_virtual/HttpLlmApplicationComposer.mjs';
+import { __require as requireLlmSchemaConverter } from '../../converters/LlmSchemaConverter2.mjs';
+import { __require as requireUtils } from '../../utils/index2.mjs';
+import { __require as requireOpenApiValidator } from '../../validators/OpenApiValidator2.mjs';
+
+var hasRequiredHttpLlmApplicationComposer;
+
+function requireHttpLlmApplicationComposer () {
+	if (hasRequiredHttpLlmApplicationComposer) return HttpLlmApplicationComposer;
+	hasRequiredHttpLlmApplicationComposer = 1;
+	Object.defineProperty(HttpLlmApplicationComposer, "__esModule", { value: true });
+	HttpLlmApplicationComposer.HttpLlmApplicationComposer = void 0;
+	const LlmSchemaConverter_1 = requireLlmSchemaConverter();
+	const utils_1 = requireUtils();
+	const OpenApiValidator_1 = requireOpenApiValidator();
+	/**
+	 * Composes {@link IHttpLlmApplication} from an {@link IHttpMigrateApplication}.
+	 *
+	 * Converts OpenAPI-migrated HTTP routes into LLM function calling schemas,
+	 * filtering out unsupported methods (HEAD) and content types
+	 * (multipart/form-data), and shortening function names to fit the configured
+	 * maximum length.
+	 */
+	var HttpLlmApplicationComposer$1;
+	(function (HttpLlmApplicationComposer) {
+	    /**
+	     * Builds an {@link IHttpLlmApplication} from migrated HTTP routes.
+	     *
+	     * Iterates all routes, converts each to an {@link IHttpLlmFunction}, and
+	     * collects conversion errors. Applies function name shortening at the end.
+	     */
+	    HttpLlmApplicationComposer.application = (props) => {
+	        var _a, _b, _c, _d;
+	        var _e, _f, _g, _h;
+	        // fill in config defaults
+	        const config = {
+	            maxLength: (_e = (_a = props.config) === null || _a === void 0 ? void 0 : _a.maxLength) !== null && _e !== void 0 ? _e : 64,
+	            equals: (_f = (_b = props.config) === null || _b === void 0 ? void 0 : _b.equals) !== null && _f !== void 0 ? _f : false,
+	            strict: (_g = (_c = props.config) === null || _c === void 0 ? void 0 : _c.strict) !== null && _g !== void 0 ? _g : false,
+	        };
+	        // seed with pre-existing migration errors, excluding human-only endpoints
+	        const errors = props.migrate.errors
+	            .filter((e) => e.operation()["x-samchon-human"] !== true)
+	            .map((e) => ({
+	            method: e.method,
+	            path: e.path,
+	            messages: e.messages,
+	            operation: () => e.operation(),
+	            route: () => undefined,
+	        }));
+	        // convert each route to an LLM function, rejecting unsupported ones
+	        const functions = props.migrate.routes
+	            .filter((e) => e.operation()["x-samchon-human"] !== true)
+	            .map((route, i) => {
+	            var _a, _b;
+	            // reject HEAD — LLMs cannot interpret header-only responses
+	            if (route.method === "head") {
+	                errors.push({
+	                    method: route.method,
+	                    path: route.path,
+	                    messages: ["HEAD method is not supported in the LLM application."],
+	                    operation: () => route.operation(),
+	                    route: () => route,
+	                });
+	                return null;
+	                // reject multipart/form-data — binary uploads not expressible in JSON Schema
+	            }
+	            else if (((_a = route.body) === null || _a === void 0 ? void 0 : _a.type) === "multipart/form-data" ||
+	                ((_b = route.success) === null || _b === void 0 ? void 0 : _b.type) === "multipart/form-data") {
+	                errors.push({
+	                    method: route.method,
+	                    path: route.path,
+	                    messages: [
+	                        `The "multipart/form-data" content type is not supported in the LLM application.`,
+	                    ],
+	                    operation: () => route.operation(),
+	                    route: () => route,
+	                });
+	                return null;
+	            }
+	            const localErrors = [];
+	            const func = composeFunction({
+	                components: props.migrate.document().components,
+	                config,
+	                route,
+	                errors: localErrors});
+	            if (func === null)
+	                errors.push({
+	                    method: route.method,
+	                    path: route.path,
+	                    messages: localErrors,
+	                    operation: () => route.operation(),
+	                    route: () => route,
+	                });
+	            return func;
+	        })
+	            .filter((v) => v !== null);
+	        const app = {
+	            config,
+	            functions,
+	            errors,
+	        };
+	        HttpLlmApplicationComposer.shorten(app, (_h = (_d = props.config) === null || _d === void 0 ? void 0 : _d.maxLength) !== null && _h !== void 0 ? _h : 64);
+	        return app;
+	    };
+	    /**
+	     * Converts a single {@link IHttpMigrateRoute} into an {@link IHttpLlmFunction}
+	     * by composing parameter/output schemas and validating function name
+	     * constraints.
+	     */
+	    const composeFunction = (props) => {
+	        var _a, _b, _c, _d, _e, _f, _g, _h;
+	        // accessor prefix for error messages (mirrors OpenAPI document structure)
+	        const endpoint = `$input.paths[${JSON.stringify(props.route.path)}][${JSON.stringify(props.route.method)}]`;
+	        const operation = props.route.operation();
+	        const description = concatDescription({
+	            summary: operation.summary,
+	            description: operation.description,
+	        });
+	        if (((_a = description === null || description === void 0 ? void 0 : description.length) !== null && _a !== void 0 ? _a : 0) > 1024) {
+	            props.errors.push(`The description of the function is too long (must be equal or less than 1,024 characters, but ${description.length.toLocaleString()} length).`);
+	        }
+	        // build function name from route accessor, replacing forbidden chars
+	        const name = emend(props.route.accessor.join("_"));
+	        const isNameVariable = /^[a-zA-Z0-9_-]+$/.test(name);
+	        const isNameStartsWithNumber = /^[0-9]/.test((_b = name[0]) !== null && _b !== void 0 ? _b : "");
+	        if (isNameVariable === false)
+	            props.errors.push(`Elements of path (separated by '/') must be composed with alphabets, numbers, underscores, and hyphens`);
+	        if (isNameStartsWithNumber === true)
+	            props.errors.push(`Function name cannot start with a number.`);
+	        //----
+	        // CONSTRUCT SCHEMAS
+	        //----
+	        // merge path parameters, query, and body into a single object schema
+	        const parameters = {
+	            type: "object",
+	            properties: Object.fromEntries([
+	                // path parameters (e.g., /users/:id)
+	                ...props.route.parameters.map((s) => { var _a; return [
+	                    s.key,
+	                    Object.assign(Object.assign({}, s.schema), { description: (_a = s.parameter().description) !== null && _a !== void 0 ? _a : s.schema.description }),
+	                ]; }),
+	                // query parameters
+	                ...(props.route.query
+	                    ? [
+	                        [
+	                            props.route.query.key,
+	                            Object.assign(Object.assign({}, props.route.query.schema), { title: (_c = props.route.query.title()) !== null && _c !== void 0 ? _c : props.route.query.schema.title, description: (_d = props.route.query.description()) !== null && _d !== void 0 ? _d : props.route.query.schema.description }),
+	                        ],
+	                    ]
+	                    : []),
+	                // request body
+	                ...(props.route.body
+	                    ? [
+	                        [
+	                            props.route.body.key,
+	                            Object.assign(Object.assign({}, props.route.body.schema), { description: (_e = props.route.body.description()) !== null && _e !== void 0 ? _e : props.route.body.schema.description }),
+	                        ],
+	                    ]
+	                    : []),
+	            ]),
+	        };
+	        parameters.required = Object.keys((_f = parameters.properties) !== null && _f !== void 0 ? _f : {});
+	        // convert merged object schema to LLM parameters
+	        const llmParameters = LlmSchemaConverter_1.LlmSchemaConverter.parameters({
+	            config: props.config,
+	            components: props.components,
+	            schema: parameters,
+	            accessor: `${endpoint}.parameters`,
+	        });
+	        // convert response schema to LLM output parameters
+	        const output = props.route.success
+	            ? LlmSchemaConverter_1.LlmSchemaConverter.parameters({
+	                config: props.config,
+	                components: props.components,
+	                schema: props.route.success.schema,
+	                accessor: `${endpoint}.responses[${JSON.stringify(props.route.success.status)}][${JSON.stringify(props.route.success.type)}].schema`,
+	            })
+	            : undefined;
+	        //----
+	        // CONVERSION
+	        //----
+	        // bail out if any validation or conversion failed
+	        if ((output === null || output === void 0 ? void 0 : output.success) === false ||
+	            llmParameters.success === false ||
+	            isNameVariable === false ||
+	            isNameStartsWithNumber === true ||
+	            ((_g = description === null || description === void 0 ? void 0 : description.length) !== null && _g !== void 0 ? _g : 0) > 1024) {
+	            if ((output === null || output === void 0 ? void 0 : output.success) === false)
+	                props.errors.push(...output.error.reasons.map((r) => `${r.accessor}: ${r.message}`));
+	            if (llmParameters.success === false)
+	                props.errors.push(
+	                // rewrite internal accessor to match OpenAPI requestBody path
+	                ...llmParameters.error.reasons.map((r) => {
+	                    var _a;
+	                    var _b;
+	                    const accessor = r.accessor.replace(`parameters.properties["body"]`, `requestBody.content[${JSON.stringify((_b = (_a = props.route.body) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : "application/json")}].schema`);
+	                    return `${accessor}: ${r.message}`;
+	                }));
+	            return null;
+	        }
+	        // assemble the LLM function
+	        return {
+	            method: props.route.method,
+	            path: props.route.path,
+	            name,
+	            parameters: llmParameters.value,
+	            output: output === null || output === void 0 ? void 0 : output.value,
+	            description,
+	            deprecated: operation.deprecated,
+	            tags: operation.tags,
+	            parse: (input) => utils_1.LlmJson.parse(input, llmParameters.value),
+	            coerce: (input) => utils_1.LlmJson.coerce(input, llmParameters.value),
+	            validate: OpenApiValidator_1.OpenApiValidator.create({
+	                components: props.components,
+	                schema: parameters,
+	                required: true,
+	                equals: (_h = props.config.equals) !== null && _h !== void 0 ? _h : false,
+	            }),
+	            route: () => props.route,
+	            operation: () => props.route.operation(),
+	        };
+	    };
+	    /**
+	     * Shortens function names exceeding the character limit.
+	     *
+	     * Tries progressively shorter accessor suffixes first, then falls back to
+	     * index-prefixed names, and finally UUID as a last resort.
+	     */
+	    HttpLlmApplicationComposer.shorten = (app, limit = 64) => {
+	        // collect all names for uniqueness checks
+	        const dictionary = new Set();
+	        const longFunctions = [];
+	        for (const func of app.functions) {
+	            dictionary.add(func.name);
+	            if (func.name.length > limit) {
+	                longFunctions.push(func);
+	            }
+	        }
+	        if (longFunctions.length === 0)
+	            return;
+	        let index = 0;
+	        for (const func of longFunctions) {
+	            let success = false;
+	            const rename = (str) => {
+	                dictionary.delete(func.name);
+	                dictionary.add(str);
+	                func.name = str;
+	                success = true;
+	            };
+	            // try dropping leading accessor segments to shorten the name
+	            // (e.g., "api_users_getById" → "users_getById" → "getById")
+	            for (let i = 1; i < func.route().accessor.length; ++i) {
+	                const shortName = func.route().accessor.slice(i).join("_");
+	                if (shortName.length > limit - 8)
+	                    continue; // reserve room for "_N_" prefix
+	                else if (dictionary.has(shortName) === false)
+	                    rename(shortName);
+	                else {
+	                    // name collision — prefix with a counter to disambiguate
+	                    const newName = `_${index}_${shortName}`;
+	                    if (dictionary.has(newName) === true)
+	                        continue;
+	                    rename(newName);
+	                    ++index;
+	                }
+	                break;
+	            }
+	            // last resort — all suffix attempts failed or collided
+	            if (success === false)
+	                rename(randomFormatUuid());
+	        }
+	    };
+	})(HttpLlmApplicationComposer$1 || (HttpLlmApplicationComposer.HttpLlmApplicationComposer = HttpLlmApplicationComposer$1 = {}));
+	const randomFormatUuid = () => "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+	    const r = (Math.random() * 16) | 0;
+	    const v = c === "x" ? r : (r & 0x3) | 0x8;
+	    return v.toString(16);
+	});
+	/** Replaces forbidden characters (`$`, `%`, `.`) with underscores. */
+	const emend = (str) => {
+	    for (const ch of FORBIDDEN)
+	        str = str.split(ch).join("_");
+	    return str;
+	};
+	const FORBIDDEN = ["$", "%", "."];
+	/**
+	 * Concatenates summary and description into a single string.
+	 *
+	 * If both are present, joins them with a period and double newline, avoiding
+	 * duplication when the description already starts with the summary.
+	 */
+	const concatDescription = (p) => {
+	    var _a, _b;
+	    if (!((_a = p.summary) === null || _a === void 0 ? void 0 : _a.length) || !((_b = p.description) === null || _b === void 0 ? void 0 : _b.length))
+	        return p.summary || p.description;
+	    const summary = p.summary.endsWith(".")
+	        ? p.summary.slice(0, -1)
+	        : p.summary;
+	    return p.description.startsWith(summary)
+	        ? p.description
+	        : summary + ".\n\n" + p.description;
+	};
+	
+	return HttpLlmApplicationComposer;
+}
+
+export { requireHttpLlmApplicationComposer as __require };
+//# sourceMappingURL=HttpLlmApplicationComposer2.mjs.map