@autobe/agent 0.24.2 → 0.25.1

package/lib/orchestrate/interface/orchestrateInterfacePrerequisites.js

@@ -0,0 +1,713 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orchestrateInterfacePrerequisites = orchestrateInterfacePrerequisites;
+const __typia_transform__validateReport = __importStar(require("typia/lib/internal/_validateReport.js"));
+const __typia_transform__llmApplicationFinalize = __importStar(require("typia/lib/internal/_llmApplicationFinalize.js"));
+const utils_1 = require("@autobe/utils");
+const tstl_1 = require("tstl");
+const typia_1 = __importDefault(require("typia"));
+const uuid_1 = require("uuid");
+const assertSchemaModel_1 = require("../../context/assertSchemaModel");
+const divideArray_1 = require("../../utils/divideArray");
+const executeCachedBatch_1 = require("../../utils/executeCachedBatch");
+const transformInterfacePrerequisitesHistories_1 = require("./histories/transformInterfacePrerequisitesHistories");
+function orchestrateInterfacePrerequisites(ctx_1, document_1) {
+    return __awaiter(this, arguments, void 0, function* (ctx, document, capacity = 4 /* AutoBeConfigConstant.INTERFACE_CAPACITY */) {
+        var _a;
+        const operations = (_a = document.operations.filter((op) => op.authorizationType === null)) !== null && _a !== void 0 ? _a : [];
+        const progress = {
+            total: operations.length,
+            completed: 0,
+        };
+        const prerequisiteOperations = document.operations.filter((op) => op.authorizationType === null && op.method === "post");
+        const dict = new tstl_1.HashMap(prerequisiteOperations.map((op) => new tstl_1.Pair({ path: op.path, method: op.method }, op)), utils_1.AutoBeOpenApiEndpointComparator.hashCode, utils_1.AutoBeOpenApiEndpointComparator.equals);
+        const prerequisitesNotFound = [
+            `You have to select one of the endpoints below`,
+            "",
+            " method | path ",
+            "--------|------",
+            ...prerequisiteOperations
+                .map((op) => `\`${op.method}\` | \`${op.path}\``)
+                .join("\n"),
+        ].join("\n");
+        const exclude = [];
+        let include = [...operations];
+        let trial = 0;
+        do {
+            const matrix = (0, divideArray_1.divideArray)({
+                array: include,
+                capacity: capacity !== null && capacity !== void 0 ? capacity : 4 /* AutoBeConfigConstant.INTERFACE_CAPACITY */,
+            });
+            yield (0, executeCachedBatch_1.executeCachedBatch)(matrix.map((ops) => (promptCacheKey) => __awaiter(this, void 0, void 0, function* () {
+                const row = yield divideAndConquer(ctx, {
+                    dict: dict,
+                    document,
+                    includes: ops,
+                    progress,
+                    promptCacheKey,
+                    prerequisitesNotFound,
+                });
+                exclude.push(...row);
+                return row;
+            })));
+            include = include.filter((op) => {
+                if (exclude.some((el) => el.endpoint.method === op.method && el.endpoint.path === op.path)) {
+                    return false;
+                }
+                return true;
+            });
+        } while (include.length > 0 && ++trial < ctx.retry);
+        return exclude;
+    });
+}
+function divideAndConquer(ctx, props) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const pointer = {
+            value: null,
+        };
+        try {
+            const { tokenUsage } = yield ctx.conversate({
+                source: "interfacePrerequisites",
+                controller: createController({
+                    model: ctx.model,
+                    document: props.document,
+                    dict: props.dict,
+                    includes: props.includes,
+                    prerequisitesNotFound: props.prerequisitesNotFound,
+                    build: (next) => {
+                        pointer.value = next;
+                    },
+                }),
+                histories: (0, transformInterfacePrerequisitesHistories_1.transformInterfacePrerequisitesHistories)(props.document, props.includes),
+                enforceFunctionCall: true,
+                promptCacheKey: props.promptCacheKey,
+                message: "Create prerequisite for the given operations",
+            });
+            if (pointer.value === null)
+                return [];
+            props.progress.completed += pointer.value.length;
+            ctx.dispatch({
+                type: "interfacePrerequisites",
+                id: (0, uuid_1.v7)(),
+                created_at: new Date().toISOString(),
+                tokenUsage,
+                operations: pointer.value,
+                total: props.progress.total,
+                completed: props.progress.completed,
+                step: (_b = (_a = ctx.state().prisma) === null || _a === void 0 ? void 0 : _a.step) !== null && _b !== void 0 ? _b : 0,
+            });
+            return pointer.value;
+        }
+        catch (_c) {
+            props.progress.completed += props.includes.length;
+            return [];
+        }
+    });
+}
+function createController(props) {
+    (0, assertSchemaModel_1.assertSchemaModel)(props.model);
+    const validate = (next) => {
+        const result = (() => { const _io0 = input => Array.isArray(input.operations) && input.operations.every(elem => "object" === typeof elem && null !== elem && _io1(elem)); const _io1 = input => "object" === typeof input.endpoint && null !== input.endpoint && _io2(input.endpoint) && (Array.isArray(input.prerequisites) && input.prerequisites.every(elem => "object" === typeof elem && null !== elem && _io3(elem))); const _io2 = input => "string" === typeof input.path && RegExp("^\\/[a-zA-Z0-9\\/_{}.-]*$").test(input.path) && ("get" === input.method || "post" === input.method || "put" === input.method || "delete" === input.method || "patch" === input.method); const _io3 = input => "object" === typeof input.endpoint && null !== input.endpoint && _io2(input.endpoint) && "string" === typeof input.description; const _vo0 = (input, _path, _exceptionable = true) => [(Array.isArray(input.operations) || _report(_exceptionable, {
+                path: _path + ".operations",
+                expected: "Array<IAutoBeInterfacePrerequisitesApplication.IOperation>",
+                value: input.operations
+            })) && input.operations.map((elem, _index3) => ("object" === typeof elem && null !== elem || _report(_exceptionable, {
+                path: _path + ".operations[" + _index3 + "]",
+                expected: "IAutoBeInterfacePrerequisitesApplication.IOperation",
+                value: elem
+            })) && _vo1(elem, _path + ".operations[" + _index3 + "]", true && _exceptionable) || _report(_exceptionable, {
+                path: _path + ".operations[" + _index3 + "]",
+                expected: "IAutoBeInterfacePrerequisitesApplication.IOperation",
+                value: elem
+            })).every(flag => flag) || _report(_exceptionable, {
+                path: _path + ".operations",
+                expected: "Array<IAutoBeInterfacePrerequisitesApplication.IOperation>",
+                value: input.operations
+            })].every(flag => flag); const _vo1 = (input, _path, _exceptionable = true) => [("object" === typeof input.endpoint && null !== input.endpoint || _report(_exceptionable, {
+                path: _path + ".endpoint",
+                expected: "AutoBeOpenApi.IEndpoint",
+                value: input.endpoint
+            })) && _vo2(input.endpoint, _path + ".endpoint", true && _exceptionable) || _report(_exceptionable, {
+                path: _path + ".endpoint",
+                expected: "AutoBeOpenApi.IEndpoint",
+                value: input.endpoint
+            }), (Array.isArray(input.prerequisites) || _report(_exceptionable, {
+                path: _path + ".prerequisites",
+                expected: "Array<AutoBeOpenApi.IPrerequisite>",
+                value: input.prerequisites
+            })) && input.prerequisites.map((elem, _index4) => ("object" === typeof elem && null !== elem || _report(_exceptionable, {
+                path: _path + ".prerequisites[" + _index4 + "]",
+                expected: "AutoBeOpenApi.IPrerequisite",
+                value: elem
+            })) && _vo3(elem, _path + ".prerequisites[" + _index4 + "]", true && _exceptionable) || _report(_exceptionable, {
+                path: _path + ".prerequisites[" + _index4 + "]",
+                expected: "AutoBeOpenApi.IPrerequisite",
+                value: elem
+            })).every(flag => flag) || _report(_exceptionable, {
+                path: _path + ".prerequisites",
+                expected: "Array<AutoBeOpenApi.IPrerequisite>",
+                value: input.prerequisites
+            })].every(flag => flag); const _vo2 = (input, _path, _exceptionable = true) => ["string" === typeof input.path && (RegExp("^\\/[a-zA-Z0-9\\/_{}.-]*$").test(input.path) || _report(_exceptionable, {
+                path: _path + ".path",
+                expected: "string & Pattern<\"^\\\\/[a-zA-Z0-9\\\\/_{}.-]*$\">",
+                value: input.path
+            })) || _report(_exceptionable, {
+                path: _path + ".path",
+                expected: "(string & Pattern<\"^\\\\/[a-zA-Z0-9\\\\/_{}.-]*$\">)",
+                value: input.path
+            }), "get" === input.method || "post" === input.method || "put" === input.method || "delete" === input.method || "patch" === input.method || _report(_exceptionable, {
+                path: _path + ".method",
+                expected: "(\"delete\" | \"get\" | \"patch\" | \"post\" | \"put\")",
+                value: input.method
+            })].every(flag => flag); const _vo3 = (input, _path, _exceptionable = true) => [("object" === typeof input.endpoint && null !== input.endpoint || _report(_exceptionable, {
+                path: _path + ".endpoint",
+                expected: "AutoBeOpenApi.IEndpoint",
+                value: input.endpoint
+            })) && _vo2(input.endpoint, _path + ".endpoint", true && _exceptionable) || _report(_exceptionable, {
+                path: _path + ".endpoint",
+                expected: "AutoBeOpenApi.IEndpoint",
+                value: input.endpoint
+            }), "string" === typeof input.description || _report(_exceptionable, {
+                path: _path + ".description",
+                expected: "string",
+                value: input.description
+            })].every(flag => flag); const __is = input => "object" === typeof input && null !== input && _io0(input); let errors; let _report; return input => {
+            if (false === __is(input)) {
+                errors = [];
+                _report = __typia_transform__validateReport._validateReport(errors);
+                ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                    path: _path + "",
+                    expected: "IAutoBeInterfacePrerequisitesApplication.IProps",
+                    value: input
+                })) && _vo0(input, _path + "", true) || _report(true, {
+                    path: _path + "",
+                    expected: "IAutoBeInterfacePrerequisitesApplication.IProps",
+                    value: input
+                }))(input, "$input", true);
+                const success = 0 === errors.length;
+                return success ? {
+                    success,
+                    data: input
+                } : {
+                    success,
+                    errors,
+                    data: input
+                };
+            }
+            return {
+                success: true,
+                data: input
+            };
+        }; })()(next);
+        if (result.success === false)
+            return result;
+        const operations = result.data.operations;
+        const filteredOperations = [];
+        const errors = [];
+        props.includes.forEach((el) => {
+            // Find the matched operation in the includes
+            const matched = operations.find((op) => op.endpoint.method === el.method && op.endpoint.path === el.path);
+            // Remove duplicate operations in Prerequisites
+            if (matched) {
+                const prerequisites = new Map();
+                matched.prerequisites.forEach((op) => {
+                    if (prerequisites.get(op.endpoint.method + op.endpoint.path) !==
+                        undefined) {
+                        return;
+                    }
+                    prerequisites.set(op.endpoint.method + op.endpoint.path, op);
+                });
+                matched.prerequisites = Array.from(prerequisites.values());
+                filteredOperations.push(matched);
+            }
+        });
+        filteredOperations.forEach((op, i) => {
+            op.prerequisites.forEach((p, j) => {
+                if (props.dict.has(p.endpoint) === false) {
+                    errors.push({
+                        value: p.endpoint,
+                        path: `$input.operations[${i}].prerequisites[${j}].endpoint`,
+                        expected: "AutoBeOpenApi.IEndpoint",
+                        description: props.prerequisitesNotFound,
+                    });
+                }
+                if (p.endpoint.method === op.endpoint.method &&
+                    p.endpoint.path === op.endpoint.path) {
+                    errors.push({
+                        value: p.endpoint,
+                        path: `$input.operations[${i}].prerequisites[${j}].endpoint`,
+                        expected: "AutoBeOpenApi.IEndpoint",
+                        description: "Self-reference is not allowed.",
+                    });
+                }
+            });
+        });
+        return errors.length === 0
+            ? Object.assign(Object.assign({}, result), { data: Object.assign(Object.assign({}, result.data), { operations: filteredOperations }) }) : {
+            success: false,
+            data: Object.assign(Object.assign({}, result.data), { operations: filteredOperations }),
+            errors,
+        };
+    };
+    const application = collection[props.model === "chatgpt" ? "chatgpt" : "claude"](validate);
+    return {
+        protocol: "class",
+        name: "interface",
+        application,
+        execute: {
+            makePrerequisite: (next) => {
+                props.build(next.operations);
+            },
+        },
+    };
+}
+const collection = {
+    chatgpt: (validate) => (() => {
+        const application = {
+            model: "chatgpt",
+            options: {
+                reference: true,
+                strict: false,
+                separate: null
+            },
+            functions: [
+                {
+                    name: "makePrerequisite",
+                    parameters: {
+                        description: "Current Type: {@link IAutoBeInterfacePrerequisitesApplication.IProps}",
+                        type: "object",
+                        properties: {
+                            operations: {
+                                description: "Target operations requiring prerequisite analysis.\n\nEach operation will be analyzed for dependency requirements and returned\nwith appropriate prerequisites from Available API Operations.",
+                                type: "array",
+                                items: {
+                                    $ref: "#/$defs/IAutoBeInterfacePrerequisitesApplication.IOperation"
+                                }
+                            }
+                        },
+                        required: [
+                            "operations"
+                        ],
+                        additionalProperties: false,
+                        $defs: {
+                            "IAutoBeInterfacePrerequisitesApplication.IOperation": {
+                                description: "Operation with its analyzed prerequisite dependencies.\n\nRepresents a single API operation and its complete prerequisite chain\nneeded for successful execution.\n\n### Description of {@link endpoint} property:\n\n> The API endpoint being analyzed.\n> \n> Identifies the specific operation (method + path) that needs\n> prerequisites.",
+                                type: "object",
+                                properties: {
+                                    endpoint: {
+                                        $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
+                                    },
+                                    prerequisites: {
+                                        description: "Required prerequisite operations.\n\nList of API operations that must be successfully executed before this\noperation can be performed. Based on resource creation dependencies and\nexistence validations from the analysis.",
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/AutoBeOpenApi.IPrerequisite"
+                                        }
+                                    }
+                                },
+                                required: [
+                                    "endpoint",
+                                    "prerequisites"
+                                ]
+                            },
+                            "AutoBeOpenApi.IEndpoint": {
+                                description: "API endpoint information.",
+                                type: "object",
+                                properties: {
+                                    path: {
+                                        description: "HTTP path of the API operation.\n\nThe URL path for accessing this API operation, using path parameters\nenclosed in curly braces (e.g., `/shoppings/customers/sales/{saleId}`).\n\nIt must be corresponded to the {@link parameters path parameters}.\n\nThe path structure should clearly indicate which database entity this\noperation is manipulating, helping to ensure all entities have\nappropriate API coverage.\n\nPath validation rules:\n\n- Must start with a forward slash (/)\n- Can contain only: letters (a-z, A-Z), numbers (0-9), forward slashes (/),\n  curly braces for parameters ({paramName}), hyphens (-), and underscores\n  (_)\n- Parameters must be enclosed in curly braces: {paramName}\n- Resource names should be in camelCase\n- No quotes, spaces, or invalid special characters allowed\n- No domain or role-based prefixes\n\nValid examples:\n\n- \"/users\"\n- \"/users/{userId}\"\n- \"/articles/{articleId}/comments\"\n- \"/attachmentFiles\"\n- \"/orders/{orderId}/items/{itemId}\"\n\nInvalid examples:\n\n- \"'/users'\" (contains quotes)\n- \"/user profile\" (contains space)\n- \"/users/[userId]\" (wrong bracket format)\n- \"/admin/users\" (role prefix)\n- \"/api/v1/users\" (API prefix)\n\n\n@pattern ^\\/[a-zA-Z0-9\\/_{}.-]*$",
+                                        type: "string"
+                                    },
+                                    method: {
+                                        description: "HTTP method of the API operation.\n\n**IMPORTANT**: Methods must be written in lowercase only (e.g., \"get\",\nnot \"GET\").\n\nNote that, if the API operation has {@link requestBody}, method must not\nbe `get`.\n\nAlso, even though the API operation has been designed to only get\ninformation, but it needs complicated request information, it must be\ndefined as `patch` method with {@link requestBody} data specification.\n\n- `get`: get information\n- `patch`: get information with complicated request data\n  ({@link requestBody})\n- `post`: create new record\n- `put`: update existing record\n- `delete`: remove record",
+                                        type: "string",
+                                        "enum": [
+                                            "get",
+                                            "post",
+                                            "put",
+                                            "delete",
+                                            "patch"
+                                        ]
+                                    }
+                                },
+                                required: [
+                                    "path",
+                                    "method"
+                                ]
+                            },
+                            "AutoBeOpenApi.IPrerequisite": {
+                                description: "Prerequisite API operation dependency.\n\n`IPrerequisite` defines a dependency relationship between API operations,\nspecifying that certain endpoints must be successfully called before the\ncurrent operation can proceed. This ensures proper resource validation,\nstate checking, and data availability in complex API workflows.\n\n## CRITICAL WARNING: Authentication is NOT a Prerequisite\n\n**NEVER use prerequisites for authentication or authorization checks!**\n\nPrerequisites are ONLY for business logic dependencies such as:\n\n- Checking if a resource exists\n- Verifying resource state\n- Loading required data\n\nDo NOT create prerequisites for:\n\n- Login/authentication endpoints\n- Token validation\n- Permission checks\n- User authorization verification\n\nAuthentication is handled separately via the `authorizationRole` field on\nthe operation itself. Mixing authentication with business prerequisites\ncreates confusion and incorrect test scenarios.\n\n## Core Concept\n\nPrerequisites create an execution dependency graph for API operations. They\nexplicitly declare which APIs must succeed before attempting the current\noperation, preventing invalid states and ensuring data consistency.\n\n## Structure\n\nEach prerequisite consists of:\n\n1. **endpoint**: The API endpoint that must be called first\n2. **description**: Clear explanation of why this prerequisite is required\n\n## Common Use Cases\n\n### 1. Resource Existence Validation\n\n```typescript\n{\n  \"endpoint\": { \"path\": \"/users/{userId}\", \"method\": \"get\" },\n  \"description\": \"User must exist before updating their profile\"\n}\n```\n\n### 2. Parent-Child Relationships\n\n```typescript\n{\n  \"endpoint\": { \"path\": \"/posts/{postId}\", \"method\": \"get\" },\n  \"description\": \"Post must exist before adding comments\"\n}\n```\n\n### 3. State Prerequisites\n\n```typescript\n{\n  \"endpoint\": { \"path\": \"/orders/{orderId}/status\", \"method\": \"get\" },\n  \"description\": \"Order must be in 'confirmed' state before shipping\"\n}\n```\n\n### 4. Business Logic Dependencies\n\n```typescript\n{\n  \"endpoint\": {\n    \"path\": \"/inventory/{productId}/stock\",\n    \"method\": \"get\"\n  },\n  \"description\": \"Product must have sufficient stock before creating order\"\n}\n```\n\n## Implementation Guidelines\n\n1. **Clear Descriptions**: Always explain WHY the prerequisite is needed\n2. **Minimal Dependencies**: Only include truly necessary prerequisites\n3. **Logical Order**: If multiple prerequisites exist, order them logically\n4. **Error Context**: Description should help understand failure scenarios\n5. **No Authentication**: Prerequisites must NEVER be authentication checks\n\n## Test Generation Usage\n\nThe Test Agent utilizes prerequisites to:\n\n- Set up test data in the correct sequence\n- Generate realistic test scenarios\n- Create both positive and negative test cases\n- Ensure proper cleanup in reverse dependency order\n\n## Best Practices\n\n- Keep prerequisite chains as short as possible for performance\n- Consider caching prerequisite results when safe to do so\n- Ensure prerequisite descriptions are specific, not generic\n- Validate that circular dependencies don't exist\n- Document any side effects of prerequisite calls\n- NEVER use for authentication/authorization validation\n\n### Description of {@link endpoint} property:\n\n> The API endpoint that must be called before the main operation.\n> \n> This specifies the exact HTTP method and path of the prerequisite API.\n> The endpoint must be a valid operation defined elsewhere in the API\n> specification. Path parameters in the prerequisite endpoint can reference\n> the same parameters available in the main operation.",
+                                type: "object",
+                                properties: {
+                                    endpoint: {
+                                        $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
+                                    },
+                                    description: {
+                                        description: "Clear description of why this prerequisite is required.\n\nThis description should explain:\n\n- What validation or check this prerequisite performs\n- What state or condition must be satisfied\n- What happens if this prerequisite fails\n- Any specific data from the prerequisite used by the main operation\n\nThe description helps developers understand the dependency relationship\nand aids in debugging when prerequisites fail.\n\nGuidelines for good descriptions:\n\n- Be specific about the requirement (e.g., \"must be in 'active' state\")\n- Explain business logic constraints (e.g., \"budget must not be exceeded\")\n- Explain data dependencies (e.g., \"provides pricing information needed\")\n- Keep it concise but complete\n\n> MUST be written in English. Never use other languages.",
+                                        type: "string"
+                                    }
+                                },
+                                required: [
+                                    "endpoint",
+                                    "description"
+                                ]
+                            }
+                        }
+                    },
+                    description: "Generate prerequisites for the provided operations.\n\nAnalyzes each operation's dependencies and returns the complete list with\ntheir required prerequisite chains based on resource relationships.",
+                    validate: (() => { const _io0 = input => Array.isArray(input.operations) && input.operations.every(elem => "object" === typeof elem && null !== elem && _io1(elem)); const _io1 = input => "object" === typeof input.endpoint && null !== input.endpoint && _io2(input.endpoint) && (Array.isArray(input.prerequisites) && input.prerequisites.every(elem => "object" === typeof elem && null !== elem && _io3(elem))); const _io2 = input => "string" === typeof input.path && RegExp("^\\/[a-zA-Z0-9\\/_{}.-]*$").test(input.path) && ("get" === input.method || "post" === input.method || "put" === input.method || "delete" === input.method || "patch" === input.method); const _io3 = input => "object" === typeof input.endpoint && null !== input.endpoint && _io2(input.endpoint) && "string" === typeof input.description; const _vo0 = (input, _path, _exceptionable = true) => [(Array.isArray(input.operations) || _report(_exceptionable, {
+                            path: _path + ".operations",
+                            expected: "Array<IAutoBeInterfacePrerequisitesApplication.IOperation>",
+                            value: input.operations
+                        })) && input.operations.map((elem, _index3) => ("object" === typeof elem && null !== elem || _report(_exceptionable, {
+                            path: _path + ".operations[" + _index3 + "]",
+                            expected: "IAutoBeInterfacePrerequisitesApplication.IOperation",
+                            value: elem
+                        })) && _vo1(elem, _path + ".operations[" + _index3 + "]", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".operations[" + _index3 + "]",
+                            expected: "IAutoBeInterfacePrerequisitesApplication.IOperation",
+                            value: elem
+                        })).every(flag => flag) || _report(_exceptionable, {
+                            path: _path + ".operations",
+                            expected: "Array<IAutoBeInterfacePrerequisitesApplication.IOperation>",
+                            value: input.operations
+                        })].every(flag => flag); const _vo1 = (input, _path, _exceptionable = true) => [("object" === typeof input.endpoint && null !== input.endpoint || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        })) && _vo2(input.endpoint, _path + ".endpoint", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        }), (Array.isArray(input.prerequisites) || _report(_exceptionable, {
+                            path: _path + ".prerequisites",
+                            expected: "Array<AutoBeOpenApi.IPrerequisite>",
+                            value: input.prerequisites
+                        })) && input.prerequisites.map((elem, _index4) => ("object" === typeof elem && null !== elem || _report(_exceptionable, {
+                            path: _path + ".prerequisites[" + _index4 + "]",
+                            expected: "AutoBeOpenApi.IPrerequisite",
+                            value: elem
+                        })) && _vo3(elem, _path + ".prerequisites[" + _index4 + "]", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".prerequisites[" + _index4 + "]",
+                            expected: "AutoBeOpenApi.IPrerequisite",
+                            value: elem
+                        })).every(flag => flag) || _report(_exceptionable, {
+                            path: _path + ".prerequisites",
+                            expected: "Array<AutoBeOpenApi.IPrerequisite>",
+                            value: input.prerequisites
+                        })].every(flag => flag); const _vo2 = (input, _path, _exceptionable = true) => ["string" === typeof input.path && (RegExp("^\\/[a-zA-Z0-9\\/_{}.-]*$").test(input.path) || _report(_exceptionable, {
+                            path: _path + ".path",
+                            expected: "string & Pattern<\"^\\\\/[a-zA-Z0-9\\\\/_{}.-]*$\">",
+                            value: input.path
+                        })) || _report(_exceptionable, {
+                            path: _path + ".path",
+                            expected: "(string & Pattern<\"^\\\\/[a-zA-Z0-9\\\\/_{}.-]*$\">)",
+                            value: input.path
+                        }), "get" === input.method || "post" === input.method || "put" === input.method || "delete" === input.method || "patch" === input.method || _report(_exceptionable, {
+                            path: _path + ".method",
+                            expected: "(\"delete\" | \"get\" | \"patch\" | \"post\" | \"put\")",
+                            value: input.method
+                        })].every(flag => flag); const _vo3 = (input, _path, _exceptionable = true) => [("object" === typeof input.endpoint && null !== input.endpoint || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        })) && _vo2(input.endpoint, _path + ".endpoint", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        }), "string" === typeof input.description || _report(_exceptionable, {
+                            path: _path + ".description",
+                            expected: "string",
+                            value: input.description
+                        })].every(flag => flag); const __is = input => "object" === typeof input && null !== input && _io0(input); let errors; let _report; return input => {
+                        if (false === __is(input)) {
+                            errors = [];
+                            _report = __typia_transform__validateReport._validateReport(errors);
+                            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                                path: _path + "",
+                                expected: "IAutoBeInterfacePrerequisitesApplication.IProps",
+                                value: input
+                            })) && _vo0(input, _path + "", true) || _report(true, {
+                                path: _path + "",
+                                expected: "IAutoBeInterfacePrerequisitesApplication.IProps",
+                                value: input
+                            }))(input, "$input", true);
+                            const success = 0 === errors.length;
+                            return success ? {
+                                success,
+                                data: input
+                            } : {
+                                success,
+                                errors,
+                                data: input
+                            };
+                        }
+                        return {
+                            success: true,
+                            data: input
+                        };
+                    }; })()
+                }
+            ]
+        };
+        __typia_transform__llmApplicationFinalize._llmApplicationFinalize(application, Object.assign(Object.assign({}, {
+            validate: {
+                makePrerequisite: validate,
+            },
+        }), { equals: false }));
+        return application;
+    })(),
+    claude: (validate) => (() => {
+        const application = {
+            model: "claude",
+            options: {
+                reference: true,
+                separate: null
+            },
+            functions: [
+                {
+                    name: "makePrerequisite",
+                    parameters: {
+                        description: "Current Type: {@link IAutoBeInterfacePrerequisitesApplication.IProps}",
+                        type: "object",
+                        properties: {
+                            operations: {
+                                description: "Target operations requiring prerequisite analysis.\n\nEach operation will be analyzed for dependency requirements and returned\nwith appropriate prerequisites from Available API Operations.",
+                                type: "array",
+                                items: {
+                                    $ref: "#/$defs/IAutoBeInterfacePrerequisitesApplication.IOperation"
+                                }
+                            }
+                        },
+                        required: [
+                            "operations"
+                        ],
+                        additionalProperties: false,
+                        $defs: {
+                            "IAutoBeInterfacePrerequisitesApplication.IOperation": {
+                                description: "Operation with its analyzed prerequisite dependencies.\n\nRepresents a single API operation and its complete prerequisite chain\nneeded for successful execution.",
+                                type: "object",
+                                properties: {
+                                    endpoint: {
+                                        description: "The API endpoint being analyzed.\n\nIdentifies the specific operation (method + path) that needs\nprerequisites.",
+                                        $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
+                                    },
+                                    prerequisites: {
+                                        description: "Required prerequisite operations.\n\nList of API operations that must be successfully executed before this\noperation can be performed. Based on resource creation dependencies and\nexistence validations from the analysis.",
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/AutoBeOpenApi.IPrerequisite"
+                                        }
+                                    }
+                                },
+                                required: [
+                                    "endpoint",
+                                    "prerequisites"
+                                ]
+                            },
+                            "AutoBeOpenApi.IEndpoint": {
+                                description: "API endpoint information.",
+                                type: "object",
+                                properties: {
+                                    path: {
+                                        description: "HTTP path of the API operation.\n\nThe URL path for accessing this API operation, using path parameters\nenclosed in curly braces (e.g., `/shoppings/customers/sales/{saleId}`).\n\nIt must be corresponded to the {@link parameters path parameters}.\n\nThe path structure should clearly indicate which database entity this\noperation is manipulating, helping to ensure all entities have\nappropriate API coverage.\n\nPath validation rules:\n\n- Must start with a forward slash (/)\n- Can contain only: letters (a-z, A-Z), numbers (0-9), forward slashes (/),\n  curly braces for parameters ({paramName}), hyphens (-), and underscores\n  (_)\n- Parameters must be enclosed in curly braces: {paramName}\n- Resource names should be in camelCase\n- No quotes, spaces, or invalid special characters allowed\n- No domain or role-based prefixes\n\nValid examples:\n\n- \"/users\"\n- \"/users/{userId}\"\n- \"/articles/{articleId}/comments\"\n- \"/attachmentFiles\"\n- \"/orders/{orderId}/items/{itemId}\"\n\nInvalid examples:\n\n- \"'/users'\" (contains quotes)\n- \"/user profile\" (contains space)\n- \"/users/[userId]\" (wrong bracket format)\n- \"/admin/users\" (role prefix)\n- \"/api/v1/users\" (API prefix)",
+                                        type: "string",
+                                        pattern: "^\\/[a-zA-Z0-9\\/_{}.-]*$"
+                                    },
+                                    method: {
+                                        description: "HTTP method of the API operation.\n\n**IMPORTANT**: Methods must be written in lowercase only (e.g., \"get\",\nnot \"GET\").\n\nNote that, if the API operation has {@link requestBody}, method must not\nbe `get`.\n\nAlso, even though the API operation has been designed to only get\ninformation, but it needs complicated request information, it must be\ndefined as `patch` method with {@link requestBody} data specification.\n\n- `get`: get information\n- `patch`: get information with complicated request data\n  ({@link requestBody})\n- `post`: create new record\n- `put`: update existing record\n- `delete`: remove record",
+                                        oneOf: [
+                                            {
+                                                "const": "get"
+                                            },
+                                            {
+                                                "const": "post"
+                                            },
+                                            {
+                                                "const": "put"
+                                            },
+                                            {
+                                                "const": "delete"
+                                            },
+                                            {
+                                                "const": "patch"
+                                            }
+                                        ]
+                                    }
+                                },
+                                required: [
+                                    "path",
+                                    "method"
+                                ]
+                            },
+                            "AutoBeOpenApi.IPrerequisite": {
+                                description: "Prerequisite API operation dependency.\n\n`IPrerequisite` defines a dependency relationship between API operations,\nspecifying that certain endpoints must be successfully called before the\ncurrent operation can proceed. This ensures proper resource validation,\nstate checking, and data availability in complex API workflows.\n\n## CRITICAL WARNING: Authentication is NOT a Prerequisite\n\n**NEVER use prerequisites for authentication or authorization checks!**\n\nPrerequisites are ONLY for business logic dependencies such as:\n\n- Checking if a resource exists\n- Verifying resource state\n- Loading required data\n\nDo NOT create prerequisites for:\n\n- Login/authentication endpoints\n- Token validation\n- Permission checks\n- User authorization verification\n\nAuthentication is handled separately via the `authorizationRole` field on\nthe operation itself. Mixing authentication with business prerequisites\ncreates confusion and incorrect test scenarios.\n\n## Core Concept\n\nPrerequisites create an execution dependency graph for API operations. They\nexplicitly declare which APIs must succeed before attempting the current\noperation, preventing invalid states and ensuring data consistency.\n\n## Structure\n\nEach prerequisite consists of:\n\n1. **endpoint**: The API endpoint that must be called first\n2. **description**: Clear explanation of why this prerequisite is required\n\n## Common Use Cases\n\n### 1. Resource Existence Validation\n\n```typescript\n{\n  \"endpoint\": { \"path\": \"/users/{userId}\", \"method\": \"get\" },\n  \"description\": \"User must exist before updating their profile\"\n}\n```\n\n### 2. Parent-Child Relationships\n\n```typescript\n{\n  \"endpoint\": { \"path\": \"/posts/{postId}\", \"method\": \"get\" },\n  \"description\": \"Post must exist before adding comments\"\n}\n```\n\n### 3. State Prerequisites\n\n```typescript\n{\n  \"endpoint\": { \"path\": \"/orders/{orderId}/status\", \"method\": \"get\" },\n  \"description\": \"Order must be in 'confirmed' state before shipping\"\n}\n```\n\n### 4. Business Logic Dependencies\n\n```typescript\n{\n  \"endpoint\": {\n    \"path\": \"/inventory/{productId}/stock\",\n    \"method\": \"get\"\n  },\n  \"description\": \"Product must have sufficient stock before creating order\"\n}\n```\n\n## Implementation Guidelines\n\n1. **Clear Descriptions**: Always explain WHY the prerequisite is needed\n2. **Minimal Dependencies**: Only include truly necessary prerequisites\n3. **Logical Order**: If multiple prerequisites exist, order them logically\n4. **Error Context**: Description should help understand failure scenarios\n5. **No Authentication**: Prerequisites must NEVER be authentication checks\n\n## Test Generation Usage\n\nThe Test Agent utilizes prerequisites to:\n\n- Set up test data in the correct sequence\n- Generate realistic test scenarios\n- Create both positive and negative test cases\n- Ensure proper cleanup in reverse dependency order\n\n## Best Practices\n\n- Keep prerequisite chains as short as possible for performance\n- Consider caching prerequisite results when safe to do so\n- Ensure prerequisite descriptions are specific, not generic\n- Validate that circular dependencies don't exist\n- Document any side effects of prerequisite calls\n- NEVER use for authentication/authorization validation",
+                                type: "object",
+                                properties: {
+                                    endpoint: {
+                                        description: "The API endpoint that must be called before the main operation.\n\nThis specifies the exact HTTP method and path of the prerequisite API.\nThe endpoint must be a valid operation defined elsewhere in the API\nspecification. Path parameters in the prerequisite endpoint can reference\nthe same parameters available in the main operation.",
+                                        $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
+                                    },
+                                    description: {
+                                        description: "Clear description of why this prerequisite is required.\n\nThis description should explain:\n\n- What validation or check this prerequisite performs\n- What state or condition must be satisfied\n- What happens if this prerequisite fails\n- Any specific data from the prerequisite used by the main operation\n\nThe description helps developers understand the dependency relationship\nand aids in debugging when prerequisites fail.\n\nGuidelines for good descriptions:\n\n- Be specific about the requirement (e.g., \"must be in 'active' state\")\n- Explain business logic constraints (e.g., \"budget must not be exceeded\")\n- Explain data dependencies (e.g., \"provides pricing information needed\")\n- Keep it concise but complete\n\n> MUST be written in English. Never use other languages.",
+                                        type: "string"
+                                    }
+                                },
+                                required: [
+                                    "endpoint",
+                                    "description"
+                                ]
+                            }
+                        }
+                    },
+                    description: "Generate prerequisites for the provided operations.\n\nAnalyzes each operation's dependencies and returns the complete list with\ntheir required prerequisite chains based on resource relationships.",
+                    validate: (() => { const _io0 = input => Array.isArray(input.operations) && input.operations.every(elem => "object" === typeof elem && null !== elem && _io1(elem)); const _io1 = input => "object" === typeof input.endpoint && null !== input.endpoint && _io2(input.endpoint) && (Array.isArray(input.prerequisites) && input.prerequisites.every(elem => "object" === typeof elem && null !== elem && _io3(elem))); const _io2 = input => "string" === typeof input.path && RegExp("^\\/[a-zA-Z0-9\\/_{}.-]*$").test(input.path) && ("get" === input.method || "post" === input.method || "put" === input.method || "delete" === input.method || "patch" === input.method); const _io3 = input => "object" === typeof input.endpoint && null !== input.endpoint && _io2(input.endpoint) && "string" === typeof input.description; const _vo0 = (input, _path, _exceptionable = true) => [(Array.isArray(input.operations) || _report(_exceptionable, {
+                            path: _path + ".operations",
+                            expected: "Array<IAutoBeInterfacePrerequisitesApplication.IOperation>",
+                            value: input.operations
+                        })) && input.operations.map((elem, _index3) => ("object" === typeof elem && null !== elem || _report(_exceptionable, {
+                            path: _path + ".operations[" + _index3 + "]",
+                            expected: "IAutoBeInterfacePrerequisitesApplication.IOperation",
+                            value: elem
+                        })) && _vo1(elem, _path + ".operations[" + _index3 + "]", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".operations[" + _index3 + "]",
+                            expected: "IAutoBeInterfacePrerequisitesApplication.IOperation",
+                            value: elem
+                        })).every(flag => flag) || _report(_exceptionable, {
+                            path: _path + ".operations",
+                            expected: "Array<IAutoBeInterfacePrerequisitesApplication.IOperation>",
+                            value: input.operations
+                        })].every(flag => flag); const _vo1 = (input, _path, _exceptionable = true) => [("object" === typeof input.endpoint && null !== input.endpoint || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        })) && _vo2(input.endpoint, _path + ".endpoint", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        }), (Array.isArray(input.prerequisites) || _report(_exceptionable, {
+                            path: _path + ".prerequisites",
+                            expected: "Array<AutoBeOpenApi.IPrerequisite>",
+                            value: input.prerequisites
+                        })) && input.prerequisites.map((elem, _index4) => ("object" === typeof elem && null !== elem || _report(_exceptionable, {
+                            path: _path + ".prerequisites[" + _index4 + "]",
+                            expected: "AutoBeOpenApi.IPrerequisite",
+                            value: elem
+                        })) && _vo3(elem, _path + ".prerequisites[" + _index4 + "]", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".prerequisites[" + _index4 + "]",
+                            expected: "AutoBeOpenApi.IPrerequisite",
+                            value: elem
+                        })).every(flag => flag) || _report(_exceptionable, {
+                            path: _path + ".prerequisites",
+                            expected: "Array<AutoBeOpenApi.IPrerequisite>",
+                            value: input.prerequisites
+                        })].every(flag => flag); const _vo2 = (input, _path, _exceptionable = true) => ["string" === typeof input.path && (RegExp("^\\/[a-zA-Z0-9\\/_{}.-]*$").test(input.path) || _report(_exceptionable, {
+                            path: _path + ".path",
+                            expected: "string & Pattern<\"^\\\\/[a-zA-Z0-9\\\\/_{}.-]*$\">",
+                            value: input.path
+                        })) || _report(_exceptionable, {
+                            path: _path + ".path",
+                            expected: "(string & Pattern<\"^\\\\/[a-zA-Z0-9\\\\/_{}.-]*$\">)",
+                            value: input.path
+                        }), "get" === input.method || "post" === input.method || "put" === input.method || "delete" === input.method || "patch" === input.method || _report(_exceptionable, {
+                            path: _path + ".method",
+                            expected: "(\"delete\" | \"get\" | \"patch\" | \"post\" | \"put\")",
+                            value: input.method
+                        })].every(flag => flag); const _vo3 = (input, _path, _exceptionable = true) => [("object" === typeof input.endpoint && null !== input.endpoint || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        })) && _vo2(input.endpoint, _path + ".endpoint", true && _exceptionable) || _report(_exceptionable, {
+                            path: _path + ".endpoint",
+                            expected: "AutoBeOpenApi.IEndpoint",
+                            value: input.endpoint
+                        }), "string" === typeof input.description || _report(_exceptionable, {
+                            path: _path + ".description",
+                            expected: "string",
+                            value: input.description
+                        })].every(flag => flag); const __is = input => "object" === typeof input && null !== input && _io0(input); let errors; let _report; return input => {
+                        if (false === __is(input)) {
+                            errors = [];
+                            _report = __typia_transform__validateReport._validateReport(errors);
+                            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                                path: _path + "",
+                                expected: "IAutoBeInterfacePrerequisitesApplication.IProps",
+                                value: input
+                            })) && _vo0(input, _path + "", true) || _report(true, {
+                                path: _path + "",
+                                expected: "IAutoBeInterfacePrerequisitesApplication.IProps",
+                                value: input
+                            }))(input, "$input", true);
+                            const success = 0 === errors.length;
+                            return success ? {
+                                success,
+                                data: input
+                            } : {
+                                success,
+                                errors,
+                                data: input
+                            };
+                        }
+                        return {
+                            success: true,
+                            data: input
+                        };
+                    }; })()
+                }
+            ]
+        };
+        __typia_transform__llmApplicationFinalize._llmApplicationFinalize(application, Object.assign(Object.assign({}, {
+            validate: {
+                makePrerequisite: validate,
+            },
+        }), { equals: false }));
+        return application;
+    })(),
+};
+//# sourceMappingURL=orchestrateInterfacePrerequisites.js.map