@autobe/agent 0.30.4 → 0.30.5

package/lib/orchestrate/interface/orchestrateInterfaceEndpointReview.js

@@ -80,7 +80,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                         properties: {
                             thinking: {
                                 type: "string",
-                                description: "Think before you act.\n\nBefore requesting preliminary data or completing your task, reflect on\nyour current state and explain your reasoning:\n\nFor preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):\n\n- What critical information is missing that you don't already have?\n- Why do you need it specifically right now?\n- Be brief - state the gap, don't list everything you have.\n\nFor completion (complete):\n\n- What key assets did you acquire?\n- What did you accomplish?\n- Why is it sufficient to complete?\n- Summarize - don't enumerate every single item.\n\nThis reflection helps you avoid duplicate requests and premature\ncompletion."
+                                description: "Reasoning about your current state: what's missing (preliminary) or what\nyou accomplished (completion)."
                             },
                             request: {
                                 oneOf: [
@@ -114,7 +114,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                         complete: "#/components/schemas/IAutoBeInterfaceEndpointReviewApplication.IComplete"
                                     }
                                 },
-                                description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval\n(getAnalysisSections, getDatabaseSchemas, getPreviousAnalysisSections,\ngetPreviousDatabaseSchemas, getPreviousInterfaceOperations) or completion\nof the review with all modifications (complete). When preliminary returns\nempty array, that type is removed from the union, physically preventing\nrepeated calls."
+                                description: "Action to perform. Exhausted preliminary types are removed from the\nunion."
                             }
                         },
                         required: [
@@ -127,7 +127,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                         properties: {
                             type: {
                                 "const": "getAnalysisSections",
-                                description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getAnalysisSections\" indicates this is a preliminary\ndata request for individual analysis sections."
+                                description: "Type discriminator."
                             },
                             sectionIds: {
                                 type: "array",
@@ -137,21 +137,21 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                 },
                                 minItems: 1,
                                 maxItems: 100,
-                                description: "List of section IDs to retrieve.\n\nThese are sequential integer IDs from the analysis sections catalog. Each\nID maps to a specific ### section in the requirements documents.\n\nCRITICAL: DO NOT request the same section IDs that you have already\nrequested in previous calls."
+                                description: "Section IDs to retrieve. DO NOT request same IDs already requested in\nprevious calls."
                             }
                         },
                         required: [
                             "type",
                             "sectionIds"
                         ],
-                        description: "Request to retrieve individual analysis sections by numeric ID.\n\nInstead of loading entire analysis files (~110-120KB each), this loads\nspecific ### sections (~200-600 words each) identified by integer IDs from\nthe section catalog."
+                        description: "Request to retrieve individual analysis sections by numeric ID."
                     },
                     IAutoBePreliminaryGetDatabaseSchemas: {
                         type: "object",
                         properties: {
                             type: {
                                 "const": "getDatabaseSchemas",
-                                description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getDatabaseSchemas\" indicates this is a preliminary\ndata request for database schemas."
+                                description: "Type discriminator."
                             },
                             schemaNames: {
                                 type: "array",
@@ -159,21 +159,21 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                     type: "string"
                                 },
                                 minItems: 1,
-                                description: "List of database table names to retrieve.\n\nTable names from the database schema representing database entities (e.g.,\n\"user\", \"post\", \"comment\").\n\nCRITICAL: DO NOT request the same schema names that you have already\nrequested in previous calls."
+                                description: "Database table names to retrieve. DO NOT request same names already\nrequested in previous calls."
                             }
                         },
                         required: [
                             "type",
                             "schemaNames"
                         ],
-                        description: "Request to retrieve database schema definitions for context.\n\nThis type is used in the preliminary phase to request specific database table\nschemas needed for generating type-safe API operations."
+                        description: "Request to retrieve database schema definitions for context."
                     },
                     IAutoBePreliminaryGetPreviousAnalysisSections: {
                         type: "object",
                         properties: {
                             type: {
                                 "const": "getPreviousAnalysisSections",
-                                description: "Type discriminator for the request.\n\nValue \"getPreviousAnalysisSections\" indicates this is a preliminary data\nrequest for analysis sections from the previous iteration."
+                                description: "Type discriminator."
                             },
                             sectionIds: {
                                 type: "array",
@@ -182,21 +182,21 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                     minimum: 0
                                 },
                                 minItems: 1,
-                                description: "List of section IDs to retrieve from the previous iteration.\n\nCRITICAL: DO NOT request the same section IDs that you have already\nrequested in previous calls."
+                                description: "Section IDs to retrieve from previous iteration. DO NOT request same IDs\nalready requested in previous calls."
                             }
                         },
                         required: [
                             "type",
                             "sectionIds"
                         ],
-                        description: "Request to retrieve individual analysis sections from previous iteration by\nnumeric ID.\n\nSame as {@link IAutoBePreliminaryGetAnalysisSections} but for sections from\nthe previous generation cycle, enabling comparison and consistency checks."
+                        description: "Request to retrieve analysis sections from the previous iteration by numeric\nID."
                     },
                     IAutoBePreliminaryGetPreviousDatabaseSchemas: {
                         type: "object",
                         properties: {
                             type: {
                                 "const": "getPreviousDatabaseSchemas",
-                                description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getPreviousDatabaseSchemas\" indicates this is a\npreliminary data request for database schemas from a previous version."
+                                description: "Type discriminator."
                             },
                             schemaNames: {
                                 type: "array",
@@ -204,21 +204,21 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                     type: "string"
                                 },
                                 minItems: 1,
-                                description: "List of database table names to retrieve from the previous version.\n\nThese are table schema names that were generated in a previous version and\nare needed as reference context for the current regeneration.\n\n**Important Notes:**\n\n- These schemas MUST exist in the previous version\n- This function is only available when a previous version exists\n- Used for reference/comparison, not for re-requesting within same execution\n- Table names are in snake_case (e.g., \"shopping_sale\", \"bbs_article\")\n\n**When This Function is Available:**\n\n- When a previous version exists\n- When user requests modifications to existing database schema\n- During correction/regeneration cycles that need previous schema context\n\n**When This Function is NOT Available:**\n\n- During initial generation (no previous version exists)\n- No previous database schemas available for this orchestration task\n\n**Example Table Names:**\n\n- \"users\", \"posts\", \"comments\"\n- \"shopping_sales\", \"shopping_orders\", \"shopping_products\"\n- \"bbs_articles\", \"bbs_article_files\""
+                                description: "Table names to retrieve from previous iteration. DO NOT request same names\nalready requested in previous calls."
                             }
                         },
                         required: [
                             "type",
                             "schemaNames"
                         ],
-                        description: "Request to retrieve database schemas from a previous version.\n\nThis type is used to load database schema definitions that were generated in\na **previous version** of the AutoBE generation pipeline. This is NOT about\nre-requesting schemas within the same execution, but rather accessing\nartifacts from an earlier version.\n\n**Use Case:** When regenerating or modifying the database schema based on\nuser change requests, agents need to reference the previously generated\ndatabase schemas to understand the existing database structure and what needs\nto be modified.\n\n**Key Difference from `getDatabaseSchemas`:**\n\n- `getDatabaseSchemas`: Fetches schemas from the **current version** (the\n  version being generated right now)\n- `getPreviousDatabaseSchemas`: Fetches schemas from the **previous version**\n  (the last successfully generated version)\n\n**Example Scenario:**\n\n    Initial generation:\n    - DATABASE phase creates: users, posts, comments tables\n    - Generation completes successfully\n\n    User: \"Add email verification status to users\"\n\n    Regeneration:\n    - DATABASE phase starts regeneration\n    - Calls getPreviousDatabaseSchemas([\"users\"])\n      \u2192 Loads the previous version of users table schema\n    - Creates new version with emailVerified field added\n\n**Waterfall + Spiral Pattern:**\n\nThis aligns with AutoBE's regeneration cycles where:\n\n- Compilation failures trigger regeneration with corrections\n- User modifications trigger new versions\n- Previous schemas serve as reference for incremental changes"
+                        description: "Request to retrieve database schemas from the previous iteration.\n\nLoads database table definitions from the last successfully generated\nversion, used as reference context during regeneration or modification\ncycles."
                     },
                     IAutoBePreliminaryGetPreviousInterfaceOperations: {
                         type: "object",
                         properties: {
                             type: {
                                 "const": "getPreviousInterfaceOperations",
-                                description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getPreviousInterfaceOperations\" indicates this is a\npreliminary data request for interface operations from a previous version."
+                                description: "Type discriminator."
                             },
                             endpoints: {
                                 type: "array",
@@ -226,14 +226,14 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                     $ref: "#/components/schemas/AutoBeOpenApi.IEndpoint"
                                 },
                                 minItems: 1,
-                                description: "List of API operation endpoints to retrieve from the previous version.\n\nThese are endpoint identifiers (method + path) that were generated in a\nprevious version and are needed as reference context for the current\nregeneration.\n\n**Important Notes:**\n\n- These endpoints MUST exist in the previous version\n- This function is only available when a previous version exists\n- Used for reference/comparison, not for re-requesting within same execution\n- Each endpoint is identified by: `{method: \"GET|POST|PUT|DELETE|PATCH\",\n  path: \"/api/path\"}`\n\n**When This Function is Available:**\n\n- When a previous version exists\n- When user requests modifications to existing API operations\n- During correction/regeneration cycles that need previous operation context\n\n**When This Function is NOT Available:**\n\n- During initial generation (no previous version exists)\n- No previous interface operations available for this orchestration task\n\n**Endpoint Format:**\n\n- Method: HTTP verb in uppercase (e.g., \"GET\", \"POST\", \"PUT\", \"DELETE\",\n  \"PATCH\")\n- Path: OpenAPI path with parameters (e.g., \"/users/{id}\", \"/posts\")\n\n**Example Endpoints:**\n\n- `{method: \"GET\", path: \"/users/{id}\"}`\n- `{method: \"POST\", path: \"/shoppings/orders\"}`\n- `{method: \"PATCH\", path: \"/bbs/articles\"}`"
+                                description: "Endpoints to retrieve from previous iteration. DO NOT request same\nendpoints already requested in previous calls."
                             }
                         },
                         required: [
                             "type",
                             "endpoints"
                         ],
-                        description: "Request to retrieve interface operations from a previous version.\n\nThis type is used to load API operation definitions that were generated in a\n**previous version** of the AutoBE generation pipeline. This is NOT about\nre-requesting operations within the same execution, but rather accessing\nartifacts from an earlier version.\n\n**Use Case:** When regenerating or modifying API operations based on user\nchange requests, agents need to reference the previously generated operations\nto understand the existing API design and what needs to be modified.\n\n**Key Difference from `getInterfaceOperations`:**\n\n- `getInterfaceOperations`: Fetches operations from the **current version**\n  (the version being generated right now)\n- `getPreviousInterfaceOperations`: Fetches operations from the **previous\n  version** (the last successfully generated version)\n\n**Example Scenario:**\n\n    Initial generation:\n    - INTERFACE phase creates: GET /users, POST /users, GET /users/{id}\n    - Generation completes successfully\n\n    User: \"Change user creation to require email verification\"\n\n    Regeneration:\n    - INTERFACE phase starts regeneration\n    - Calls getPreviousInterfaceOperations([{method: \"POST\", path: \"/users\"}])\n      \u2192 Loads the previous version of POST /users operation\n    - Creates new version with emailVerification requirement in request body\n\n**Automatic Schema Loading:**\n\nWhen operations are loaded from the previous version, their associated\nrequest/response body schemas are also referenced, providing complete context\nfor understanding the operation's data structures.\n\n**Waterfall + Spiral Pattern:**\n\nThis aligns with AutoBE's regeneration cycles where:\n\n- Compilation failures trigger regeneration with corrections\n- User modifications trigger new versions\n- Previous operations serve as reference for incremental API changes"
+                        description: "Request to retrieve interface operations from the previous iteration.\n\nLoads API operation definitions from the last successfully generated version,\nused as reference context during regeneration or modification cycles."
                     },
                     "AutoBeOpenApi.IEndpoint": {
                         type: "object",
@@ -241,7 +241,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             path: {
                                 type: "string",
                                 pattern: "^\\/[a-zA-Z0-9\\/_{}.-]*$",
-                                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)"
+                                description: "HTTP path of the API operation.\n\nMust start with `/`. Parameters use curly braces: `{paramName}`. Resource\nnames in camelCase. No quotes, spaces, role prefixes (`/admin/`), or API\nversion prefixes (`/api/v1/`).\n\nAllowed characters: letters, digits, `/`, `{`, `}`, `-`, `_`, `.`"
                             },
                             method: {
                                 oneOf: [
@@ -261,7 +261,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                         "const": "patch"
                                     }
                                 ],
-                                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"
+                                description: "HTTP method (lowercase only).\n\nUse `patch` (not `get`) when a read operation needs a complex\n{@link requestBody}. `get` cannot have a request body."
                             }
                         },
                         required: [
@@ -275,18 +275,18 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                         properties: {
                             type: {
                                 "const": "complete",
-                                description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"complete\" indicates this is the final task\nexecution request."
+                                description: "Type discriminator for completion request."
                             },
                             review: {
                                 type: "string",
-                                description: "Summary of issues found and fixes applied during review.\n\nDocument all issues discovered during endpoint validation:\n\n- What duplicates, inconsistencies, or design issues were found?\n- What endpoints needed to be added, modified, or removed?\n- What patterns or conventions were violated?\n\nState \"No issues found.\" if all endpoints pass review."
+                                description: "Summary of issues found and fixes applied. State \"No issues found.\" if\nall pass."
                             },
                             revises: {
                                 type: "array",
                                 items: {
                                     $ref: "#/components/schemas/AutoBeInterfaceEndpointRevise"
                                 },
-                                description: "Revision decisions for ALL endpoints.\n\nYou MUST provide exactly one revision for each endpoint in the provided\nlist. No omissions allowed.\n\n- Use **keep** for endpoints that are correct (do NOT simply omit them)\n- Use **create** to add missing endpoints\n- Use **update** to fix incorrectly structured endpoints\n- Use **erase** to remove invalid or duplicate endpoints\n\nThe endpoint field in keep, update, and erase must exactly match an\nendpoint from the provided list (path + method)."
+                                description: "Revision decisions for ALL endpoints. One revision per endpoint, no\nomissions. The endpoint field in keep/update/erase must exactly match a\nprovided endpoint (path + method)."
                             }
                         },
                         required: [
@@ -294,7 +294,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             "review",
                             "revises"
                         ],
-                        description: "Request to complete the endpoint review process.\n\nFinalizes the review by submitting revision decisions for ALL endpoints.\nEvery endpoint in the provided list must have exactly one revision:\n\n- **keep**: Approve endpoint as-is (explicitly confirm it's correct)\n- **create**: Add a new endpoint that was missing\n- **update**: Fix an incorrectly structured endpoint\n- **erase**: Remove an invalid or duplicate endpoint\n\nThe revisions ensure the final API structure is consistent, free of\nduplicates, properly designed, and aligned with RESTful conventions."
+                        description: "Complete endpoint review with revision decisions (keep/create/update/erase)\nfor ALL endpoints."
                     },
                     AutoBeInterfaceEndpointRevise: {
                         oneOf: [
@@ -320,18 +320,18 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                 update: "#/components/schemas/AutoBeInterfaceEndpointUpdate"
                             }
                         },
-                        description: "Endpoint revision operation type.\n\nDiscriminated union representing all possible endpoint modifications during\nthe review phase. Review agents examine generated endpoints and must return a\nrevision for **every** endpoint in the provided list - no omissions allowed.\n\n## Available Operations\n\n- **Keep**: Approve endpoint as-is (explicitly confirm it's correct)\n- **Create**: Add missing endpoints that fulfill requirements\n- **Update**: Fix incorrectly structured endpoints (path/method corrections)\n- **Erase**: Remove invalid or duplicate endpoints\n\n## Important Rules\n\n1. Every endpoint in the review list MUST have a corresponding revision\n2. Use `keep` for endpoints that are correct - do NOT simply omit them\n3. The `endpoint` field in `keep`, `update`, and `erase` must exactly match an\n   endpoint from the provided list (path + method)"
+                        description: "Endpoint revision: keep | create | update | erase.\n\nEvery endpoint in the review list MUST have a revision \u2014 no omissions."
                     },
                     AutoBeInterfaceEndpointCreate: {
                         type: "object",
                         properties: {
                             reason: {
                                 type: "string",
-                                description: "Reason for creating this endpoint.\n\nExplain which requirement this endpoint fulfills and why it was missing\nfrom the initial generation."
+                                description: "Why this endpoint is needed."
                             },
                             type: {
                                 "const": "create",
-                                description: "Type discriminator indicating this is a create operation."
+                                description: "Type discriminator."
                             },
                             design: {
                                 $ref: "#/components/schemas/AutoBeInterfaceEndpointDesign",
@@ -343,14 +343,14 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             "type",
                             "design"
                         ],
-                        description: "Request to create a new endpoint.\n\nUse this when you identify a missing endpoint that should exist based on\nrequirements analysis. Common scenarios:\n\n- A required operation was accidentally omitted from initial generation\n- A use case requires an endpoint that wasn't initially identified\n- Review reveals gaps in API coverage for specific requirements"
+                        description: "Add a missing endpoint."
                     },
                     AutoBeInterfaceEndpointDesign: {
                         type: "object",
                         properties: {
                             description: {
                                 type: "string",
-                                description: "Description of what this endpoint does.\n\nFunctional description of the endpoint's purpose and business context.\nShould explain the use case and requirements this endpoint fulfills, not\njust repeat the path/method.\n\nWrite concisely. Keep it brief and to the point."
+                                description: "Functional description of what this endpoint does and why. Keep concise."
                             },
                             authorizationActors: {
                                 type: "array",
@@ -359,7 +359,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                     pattern: "^[a-z][a-zA-Z0-9]*$",
                                     minLength: 1
                                 },
-                                description: "Authorization actors associated with this API endpoint.\n\nSpecify actors that are **associated with** this endpoint. An actor should\nbe included if:\n\n1. **The actor can call this endpoint**: The endpoint requires authentication\n   and only this actor type can access it.\n2. **The endpoint is related to the actor**: If the endpoint path contains the\n   actor name (e.g., `/auth/users/login` \u2192 `\"user\"`), or the endpoint\n   serves that actor type, include the actor to indicate the relationship.\n\n## Examples\n\n- `/auth/users/login` \u2192 `[\"user\"]` (related to user)\n- `/auth/admins/join` \u2192 `[\"admin\"]` (related to admin)\n- `/users/{userId}/profile` \u2192 `[\"user\"]` (user can call)\n- `/products` \u2192 `[]` (public, no association)\n\n## \u26A0\uFE0F Actor Multiplication Effect\n\nEach actor may generate a separate endpoint. Minimize actors to prevent\nendpoint explosion.\n\n## Naming Convention\n\nUse camelCase for all actor names (e.g., `\"user\"`, `\"admin\"`, `\"seller\"`)."
+                                description: "Authorization actors associated with this endpoint (camelCase).\n\nInclude an actor if it can call this endpoint or the endpoint is\nsemantically related to it (e.g., `/auth/users/login` \u2192 `[\"user\"]`). Empty\narray for public endpoints.\n\nEach actor may generate a separate endpoint \u2014 minimize to prevent endpoint\nexplosion."
                             },
                             authorizationType: {
                                 oneOf: [
@@ -388,7 +388,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                                         "const": "management"
                                     }
                                 ],
-                                description: "Authorization type of the API endpoint.\n\n- `\"login\"`: User login endpoint that validates credentials\n- `\"join\"`: User registration endpoint that creates accounts\n- `\"withdraw\"`: User withdrawal/deactivation endpoint that deletes accounts\n- `\"refresh\"`: Token refresh endpoint that renews access tokens\n- `\"session\"`: Session related endpoint (e.g., logout, session management)\n- `\"password\"`: Password related endpoint (e.g., reset, change password)\n- `\"management\"`: Authentication-related endpoint other than above types\n  (e.g., email/phone verification, 2FA, OAuth, profile update)\n- `null`: All other endpoints (CRUD, business logic, etc.)"
+                                description: "Authorization type of the endpoint.\n\n- `\"login\"`: Credential validation\n- `\"join\"`: Account registration\n- `\"withdraw\"`: Account deactivation\n- `\"refresh\"`: Token renewal\n- `\"session\"`: Session management (logout, etc.)\n- `\"password\"`: Password reset/change\n- `\"management\"`: Other auth-related (2FA, OAuth, verification)\n- `null`: All other endpoints"
                             },
                             endpoint: {
                                 $ref: "#/components/schemas/AutoBeOpenApi.IEndpoint",
@@ -401,22 +401,22 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             "authorizationType",
                             "endpoint"
                         ],
-                        description: "Endpoint design with description and specification.\n\nRepresents a single endpoint generated during the write phase, pairing the\nendpoint definition (path + method) with a description of its purpose.\n\nThis type formalizes the legacy\n`IAutoBeInterfaceEndpointWriteApplication.IContent` structure for reuse\nacross the codebase. The description provides business context that helps:\n\n- Review agents validate that the endpoint fulfills actual requirements\n- Operation generation create appropriate request/response schemas\n- Schema design infer correct data structures"
+                        description: "Endpoint design with description, authorization, and endpoint definition."
                     },
                     AutoBeInterfaceEndpointErase: {
                         type: "object",
                         properties: {
                             reason: {
                                 type: "string",
-                                description: "Reason for deletion.\n\nExplain why this endpoint should be removed and what issue it causes."
+                                description: "Why this endpoint should be removed."
                             },
                             endpoint: {
                                 $ref: "#/components/schemas/AutoBeOpenApi.IEndpoint",
-                                description: "The endpoint to remove.\n\n\u26A0\uFE0F CRITICAL: Must be from the \"Endpoints for Review\" list provided above.\nDO NOT reference endpoints that are not in the provided list. Must match\nexactly (path + method)."
+                                description: "Endpoint to remove. MUST match exactly (path + method) from the provided\nreview list."
                             },
                             type: {
                                 "const": "erase",
-                                description: "Type discriminator indicating this is an erase operation."
+                                description: "Type discriminator."
                             }
                         },
                         required: [
@@ -424,22 +424,22 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             "endpoint",
                             "type"
                         ],
-                        description: "Request to erase an endpoint.\n\nUse this when an endpoint should be removed from the generated set:\n\n- Duplicate functionality with another endpoint\n- Not derived from actual requirements (hallucinated)\n- Violates RESTful conventions or business rules\n- Security concern (exposes sensitive data inappropriately)\n- Over-engineering (unnecessary granularity)"
+                        description: "Remove an invalid or duplicate endpoint."
                     },
                     AutoBeInterfaceEndpointKeep: {
                         type: "object",
                         properties: {
                             reason: {
                                 type: "string",
-                                description: "Reason for keeping this endpoint unchanged.\n\nBriefly explain why this endpoint is correctly designed and needs no\nmodification. This documents the review decision."
+                                description: "Why this endpoint is correct and needs no changes."
                             },
                             endpoint: {
                                 $ref: "#/components/schemas/AutoBeOpenApi.IEndpoint",
-                                description: "The endpoint to keep unchanged.\n\n\u26A0\uFE0F CRITICAL: Must be from the \"Endpoints for Review\" list provided above.\nDO NOT reference endpoints that are not in the provided list. Must match\nexactly (path + method)."
+                                description: "Endpoint to keep. MUST match exactly (path + method) from the provided\nreview list."
                             },
                             type: {
                                 "const": "keep",
-                                description: "Type discriminator indicating this is a keep operation."
+                                description: "Type discriminator."
                             }
                         },
                         required: [
@@ -447,26 +447,26 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             "endpoint",
                             "type"
                         ],
-                        description: "Request to keep an endpoint unchanged.\n\nUse this to explicitly approve an endpoint that is correctly designed. Every\nendpoint in the review list MUST have a corresponding revision - use `keep`\nfor endpoints that need no changes rather than omitting them.\n\nThis explicit approval ensures:\n\n- Complete review coverage (no endpoints are accidentally skipped)\n- Documented reasoning for why the endpoint is correct\n- Audit trail of review decisions"
+                        description: "Approve an endpoint as correctly designed.\n\nEvery endpoint in the review list MUST have a revision \u2014 use `keep` for\ncorrect ones rather than omitting them."
                     },
                     AutoBeInterfaceEndpointUpdate: {
                         type: "object",
                         properties: {
                             reason: {
                                 type: "string",
-                                description: "Reason for this update.\n\nExplain what issue this fixes and why the new definition is better."
+                                description: "Why this fix is needed."
                             },
                             endpoint: {
                                 $ref: "#/components/schemas/AutoBeOpenApi.IEndpoint",
-                                description: "The original endpoint to modify.\n\n\u26A0\uFE0F CRITICAL: Must be from the \"Endpoints for Review\" list provided above.\nDO NOT reference endpoints that are not in the provided list. Must match\nexactly (path + method)."
+                                description: "Original endpoint to modify. MUST match exactly (path + method) from the\nprovided review list."
                             },
                             type: {
                                 "const": "update",
-                                description: "Type discriminator indicating this is an update operation."
+                                description: "Type discriminator."
                             },
                             newDesign: {
                                 $ref: "#/components/schemas/AutoBeInterfaceEndpointDesign",
-                                description: "The updated endpoint definition.\n\nContains the corrected path and/or method."
+                                description: "Corrected endpoint definition."
                             }
                         },
                         required: [
@@ -475,7 +475,7 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                             "type",
                             "newDesign"
                         ],
-                        description: "Request to update an existing endpoint.\n\nUse this when an endpoint has issues that need correction:\n\n- Path naming inconsistency (e.g., `/userProfile` vs `/users/{userId}/profile`)\n- Incorrect HTTP method (e.g., GET for mutation operations)\n- Path structure needs adjustment (e.g., hierarchical nesting)\n- Parameter naming issues (e.g., `{id}` \u2192 `{userId}`)\n- Singular/plural normalization (e.g., `/user` \u2192 `/users`)"
+                        description: "Fix an incorrectly structured endpoint (path/method corrections)."
                     }
                 }
             },
@@ -486,14 +486,13 @@ const orchestrateInterfaceEndpointReview = (ctx, props) => __awaiter(void 0, voi
                     parameters: [
                         {
                             name: "props",
-                            description: " Request containing either preliminary data request or endpoint\nreview completion",
                             required: true,
                             schema: {
                                 $ref: "#/components/schemas/IAutoBeInterfaceEndpointReviewApplication.IProps"
                             }
                         }
                     ],
-                    description: "Process endpoint review task or preliminary data requests.\n\nReviews and validates generated endpoints to ensure they meet quality\nstandards. The review process examines endpoint design, identifies issues\nsuch as duplicates or inconsistencies, and applies corrections through\nrevision operations (keep, create, update, or erase).\n\n**Critical**: Every endpoint in the provided list MUST receive a revision\ndecision. No omissions are allowed - use \"keep\" to explicitly approve\nendpoints that need no changes."
+                    description: "Process task or retrieve preliminary data. Every endpoint MUST receive a\nrevision decision."
                 }
             ]
         },
@@ -948,11 +947,11 @@ const createController = (props) => {
                     type: "object",
                     properties: {
                         thinking: {
-                            description: "Think before you act.\n\nBefore requesting preliminary data or completing your task, reflect on\nyour current state and explain your reasoning:\n\nFor preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):\n\n- What critical information is missing that you don't already have?\n- Why do you need it specifically right now?\n- Be brief - state the gap, don't list everything you have.\n\nFor completion (complete):\n\n- What key assets did you acquire?\n- What did you accomplish?\n- Why is it sufficient to complete?\n- Summarize - don't enumerate every single item.\n\nThis reflection helps you avoid duplicate requests and premature\ncompletion.",
+                            description: "Reasoning about your current state: what's missing (preliminary) or what\nyou accomplished (completion).",
                             type: "string"
                         },
                         request: {
-                            description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval\n(getAnalysisSections, getDatabaseSchemas, getPreviousAnalysisSections,\ngetPreviousDatabaseSchemas, getPreviousInterfaceOperations) or completion\nof the review with all modifications (complete). When preliminary returns\nempty array, that type is removed from the union, physically preventing\nrepeated calls.",
+                            description: "Action to perform. Exhausted preliminary types are removed from the\nunion.",
                             anyOf: [
                                 {
                                     $ref: "#/$defs/IAutoBePreliminaryGetAnalysisSections"
@@ -993,18 +992,18 @@ const createController = (props) => {
                     additionalProperties: false,
                     $defs: {
                         IAutoBePreliminaryGetAnalysisSections: {
-                            description: "Request to retrieve individual analysis sections by numeric ID.\n\nInstead of loading entire analysis files (~110-120KB each), this loads\nspecific ### sections (~200-600 words each) identified by integer IDs from\nthe section catalog.",
+                            description: "Request to retrieve individual analysis sections by numeric ID.",
                             type: "object",
                             properties: {
                                 type: {
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getAnalysisSections\" indicates this is a preliminary\ndata request for individual analysis sections.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getAnalysisSections"
                                     ]
                                 },
                                 sectionIds: {
-                                    description: "List of section IDs to retrieve.\n\nThese are sequential integer IDs from the analysis sections catalog. Each\nID maps to a specific ### section in the requirements documents.\n\nCRITICAL: DO NOT request the same section IDs that you have already\nrequested in previous calls.",
+                                    description: "Section IDs to retrieve. DO NOT request same IDs already requested in\nprevious calls.",
                                     type: "array",
                                     items: {
                                         type: "integer",
@@ -1020,18 +1019,18 @@ const createController = (props) => {
                             ]
                         },
                         IAutoBePreliminaryGetDatabaseSchemas: {
-                            description: "Request to retrieve database schema definitions for context.\n\nThis type is used in the preliminary phase to request specific database table\nschemas needed for generating type-safe API operations.",
+                            description: "Request to retrieve database schema definitions for context.",
                             type: "object",
                             properties: {
                                 type: {
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getDatabaseSchemas\" indicates this is a preliminary\ndata request for database schemas.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getDatabaseSchemas"
                                     ]
                                 },
                                 schemaNames: {
-                                    description: "List of database table names to retrieve.\n\nTable names from the database schema representing database entities (e.g.,\n\"user\", \"post\", \"comment\").\n\nCRITICAL: DO NOT request the same schema names that you have already\nrequested in previous calls.",
+                                    description: "Database table names to retrieve. DO NOT request same names already\nrequested in previous calls.",
                                     type: "array",
                                     items: {
                                         type: "string"
@@ -1045,18 +1044,18 @@ const createController = (props) => {
                             ]
                         },
                         IAutoBePreliminaryGetPreviousAnalysisSections: {
-                            description: "Request to retrieve individual analysis sections from previous iteration by\nnumeric ID.\n\nSame as {@link IAutoBePreliminaryGetAnalysisSections} but for sections from\nthe previous generation cycle, enabling comparison and consistency checks.",
+                            description: "Request to retrieve analysis sections from the previous iteration by numeric\nID.",
                             type: "object",
                             properties: {
                                 type: {
-                                    description: "Type discriminator for the request.\n\nValue \"getPreviousAnalysisSections\" indicates this is a preliminary data\nrequest for analysis sections from the previous iteration.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getPreviousAnalysisSections"
                                     ]
                                 },
                                 sectionIds: {
-                                    description: "List of section IDs to retrieve from the previous iteration.\n\nCRITICAL: DO NOT request the same section IDs that you have already\nrequested in previous calls.",
+                                    description: "Section IDs to retrieve from previous iteration. DO NOT request same IDs\nalready requested in previous calls.",
                                     type: "array",
                                     items: {
                                         type: "integer",
@@ -1071,18 +1070,18 @@ const createController = (props) => {
                             ]
                         },
                         IAutoBePreliminaryGetPreviousDatabaseSchemas: {
-                            description: "Request to retrieve database schemas from a previous version.\n\nThis type is used to load database schema definitions that were generated in\na **previous version** of the AutoBE generation pipeline. This is NOT about\nre-requesting schemas within the same execution, but rather accessing\nartifacts from an earlier version.\n\n**Use Case:** When regenerating or modifying the database schema based on\nuser change requests, agents need to reference the previously generated\ndatabase schemas to understand the existing database structure and what needs\nto be modified.\n\n**Key Difference from `getDatabaseSchemas`:**\n\n- `getDatabaseSchemas`: Fetches schemas from the **current version** (the\n  version being generated right now)\n- `getPreviousDatabaseSchemas`: Fetches schemas from the **previous version**\n  (the last successfully generated version)\n\n**Example Scenario:**\n\n    Initial generation:\n    - DATABASE phase creates: users, posts, comments tables\n    - Generation completes successfully\n\n    User: \"Add email verification status to users\"\n\n    Regeneration:\n    - DATABASE phase starts regeneration\n    - Calls getPreviousDatabaseSchemas([\"users\"])\n      \u2192 Loads the previous version of users table schema\n    - Creates new version with emailVerified field added\n\n**Waterfall + Spiral Pattern:**\n\nThis aligns with AutoBE's regeneration cycles where:\n\n- Compilation failures trigger regeneration with corrections\n- User modifications trigger new versions\n- Previous schemas serve as reference for incremental changes",
+                            description: "Request to retrieve database schemas from the previous iteration.\n\nLoads database table definitions from the last successfully generated\nversion, used as reference context during regeneration or modification\ncycles.",
                             type: "object",
                             properties: {
                                 type: {
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getPreviousDatabaseSchemas\" indicates this is a\npreliminary data request for database schemas from a previous version.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getPreviousDatabaseSchemas"
                                     ]
                                 },
                                 schemaNames: {
-                                    description: "List of database table names to retrieve from the previous version.\n\nThese are table schema names that were generated in a previous version and\nare needed as reference context for the current regeneration.\n\n**Important Notes:**\n\n- These schemas MUST exist in the previous version\n- This function is only available when a previous version exists\n- Used for reference/comparison, not for re-requesting within same execution\n- Table names are in snake_case (e.g., \"shopping_sale\", \"bbs_article\")\n\n**When This Function is Available:**\n\n- When a previous version exists\n- When user requests modifications to existing database schema\n- During correction/regeneration cycles that need previous schema context\n\n**When This Function is NOT Available:**\n\n- During initial generation (no previous version exists)\n- No previous database schemas available for this orchestration task\n\n**Example Table Names:**\n\n- \"users\", \"posts\", \"comments\"\n- \"shopping_sales\", \"shopping_orders\", \"shopping_products\"\n- \"bbs_articles\", \"bbs_article_files\"",
+                                    description: "Table names to retrieve from previous iteration. DO NOT request same names\nalready requested in previous calls.",
                                     type: "array",
                                     items: {
                                         type: "string"
@@ -1096,18 +1095,18 @@ const createController = (props) => {
                             ]
                         },
                         IAutoBePreliminaryGetPreviousInterfaceOperations: {
-                            description: "Request to retrieve interface operations from a previous version.\n\nThis type is used to load API operation definitions that were generated in a\n**previous version** of the AutoBE generation pipeline. This is NOT about\nre-requesting operations within the same execution, but rather accessing\nartifacts from an earlier version.\n\n**Use Case:** When regenerating or modifying API operations based on user\nchange requests, agents need to reference the previously generated operations\nto understand the existing API design and what needs to be modified.\n\n**Key Difference from `getInterfaceOperations`:**\n\n- `getInterfaceOperations`: Fetches operations from the **current version**\n  (the version being generated right now)\n- `getPreviousInterfaceOperations`: Fetches operations from the **previous\n  version** (the last successfully generated version)\n\n**Example Scenario:**\n\n    Initial generation:\n    - INTERFACE phase creates: GET /users, POST /users, GET /users/{id}\n    - Generation completes successfully\n\n    User: \"Change user creation to require email verification\"\n\n    Regeneration:\n    - INTERFACE phase starts regeneration\n    - Calls getPreviousInterfaceOperations([{method: \"POST\", path: \"/users\"}])\n      \u2192 Loads the previous version of POST /users operation\n    - Creates new version with emailVerification requirement in request body\n\n**Automatic Schema Loading:**\n\nWhen operations are loaded from the previous version, their associated\nrequest/response body schemas are also referenced, providing complete context\nfor understanding the operation's data structures.\n\n**Waterfall + Spiral Pattern:**\n\nThis aligns with AutoBE's regeneration cycles where:\n\n- Compilation failures trigger regeneration with corrections\n- User modifications trigger new versions\n- Previous operations serve as reference for incremental API changes",
+                            description: "Request to retrieve interface operations from the previous iteration.\n\nLoads API operation definitions from the last successfully generated version,\nused as reference context during regeneration or modification cycles.",
                             type: "object",
                             properties: {
                                 type: {
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getPreviousInterfaceOperations\" indicates this is a\npreliminary data request for interface operations from a previous version.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getPreviousInterfaceOperations"
                                     ]
                                 },
                                 endpoints: {
-                                    description: "List of API operation endpoints to retrieve from the previous version.\n\nThese are endpoint identifiers (method + path) that were generated in a\nprevious version and are needed as reference context for the current\nregeneration.\n\n**Important Notes:**\n\n- These endpoints MUST exist in the previous version\n- This function is only available when a previous version exists\n- Used for reference/comparison, not for re-requesting within same execution\n- Each endpoint is identified by: `{method: \"GET|POST|PUT|DELETE|PATCH\",\n  path: \"/api/path\"}`\n\n**When This Function is Available:**\n\n- When a previous version exists\n- When user requests modifications to existing API operations\n- During correction/regeneration cycles that need previous operation context\n\n**When This Function is NOT Available:**\n\n- During initial generation (no previous version exists)\n- No previous interface operations available for this orchestration task\n\n**Endpoint Format:**\n\n- Method: HTTP verb in uppercase (e.g., \"GET\", \"POST\", \"PUT\", \"DELETE\",\n  \"PATCH\")\n- Path: OpenAPI path with parameters (e.g., \"/users/{id}\", \"/posts\")\n\n**Example Endpoints:**\n\n- `{method: \"GET\", path: \"/users/{id}\"}`\n- `{method: \"POST\", path: \"/shoppings/orders\"}`\n- `{method: \"PATCH\", path: \"/bbs/articles\"}`",
+                                    description: "Endpoints to retrieve from previous iteration. DO NOT request same\nendpoints already requested in previous calls.",
                                     type: "array",
                                     items: {
                                         $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
@@ -1125,12 +1124,12 @@ const createController = (props) => {
                             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)",
+                                    description: "HTTP path of the API operation.\n\nMust start with `/`. Parameters use curly braces: `{paramName}`. Resource\nnames in camelCase. No quotes, spaces, role prefixes (`/admin/`), or API\nversion prefixes (`/api/v1/`).\n\nAllowed characters: letters, digits, `/`, `{`, `}`, `-`, `_`, `.`",
                                     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",
+                                    description: "HTTP method (lowercase only).\n\nUse `patch` (not `get`) when a read operation needs a complex\n{@link requestBody}. `get` cannot have a request body.",
                                     type: "string",
                                     "enum": [
                                         "get",
@@ -1147,22 +1146,22 @@ const createController = (props) => {
                             ]
                         },
                         "IAutoBeInterfaceEndpointReviewApplication.IComplete": {
-                            description: "Request to complete the endpoint review process.\n\nFinalizes the review by submitting revision decisions for ALL endpoints.\nEvery endpoint in the provided list must have exactly one revision:\n\n- **keep**: Approve endpoint as-is (explicitly confirm it's correct)\n- **create**: Add a new endpoint that was missing\n- **update**: Fix an incorrectly structured endpoint\n- **erase**: Remove an invalid or duplicate endpoint\n\nThe revisions ensure the final API structure is consistent, free of\nduplicates, properly designed, and aligned with RESTful conventions.",
+                            description: "Complete endpoint review with revision decisions (keep/create/update/erase)\nfor ALL endpoints.",
                             type: "object",
                             properties: {
                                 type: {
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"complete\" indicates this is the final task\nexecution request.",
+                                    description: "Type discriminator for completion request.",
                                     type: "string",
                                     "enum": [
                                         "complete"
                                     ]
                                 },
                                 review: {
-                                    description: "Summary of issues found and fixes applied during review.\n\nDocument all issues discovered during endpoint validation:\n\n- What duplicates, inconsistencies, or design issues were found?\n- What endpoints needed to be added, modified, or removed?\n- What patterns or conventions were violated?\n\nState \"No issues found.\" if all endpoints pass review.",
+                                    description: "Summary of issues found and fixes applied. State \"No issues found.\" if\nall pass.",
                                     type: "string"
                                 },
                                 revises: {
-                                    description: "Revision decisions for ALL endpoints.\n\nYou MUST provide exactly one revision for each endpoint in the provided\nlist. No omissions allowed.\n\n- Use **keep** for endpoints that are correct (do NOT simply omit them)\n- Use **create** to add missing endpoints\n- Use **update** to fix incorrectly structured endpoints\n- Use **erase** to remove invalid or duplicate endpoints\n\nThe endpoint field in keep, update, and erase must exactly match an\nendpoint from the provided list (path + method).",
+                                    description: "Revision decisions for ALL endpoints. One revision per endpoint, no\nomissions. The endpoint field in keep/update/erase must exactly match a\nprovided endpoint (path + method).",
                                     type: "array",
                                     items: {
                                         $ref: "#/$defs/AutoBeInterfaceEndpointRevise"
@@ -1176,7 +1175,7 @@ const createController = (props) => {
                             ]
                         },
                         AutoBeInterfaceEndpointRevise: {
-                            description: "Endpoint revision operation type.\n\nDiscriminated union representing all possible endpoint modifications during\nthe review phase. Review agents examine generated endpoints and must return a\nrevision for **every** endpoint in the provided list - no omissions allowed.\n\n## Available Operations\n\n- **Keep**: Approve endpoint as-is (explicitly confirm it's correct)\n- **Create**: Add missing endpoints that fulfill requirements\n- **Update**: Fix incorrectly structured endpoints (path/method corrections)\n- **Erase**: Remove invalid or duplicate endpoints\n\n## Important Rules\n\n1. Every endpoint in the review list MUST have a corresponding revision\n2. Use `keep` for endpoints that are correct - do NOT simply omit them\n3. The `endpoint` field in `keep`, `update`, and `erase` must exactly match an\n   endpoint from the provided list (path + method)",
+                            description: "Endpoint revision: keep | create | update | erase.\n\nEvery endpoint in the review list MUST have a revision \u2014 no omissions.",
                             anyOf: [
                                 {
                                     $ref: "#/$defs/AutoBeInterfaceEndpointCreate"
@@ -1202,15 +1201,15 @@ const createController = (props) => {
                             }
                         },
                         AutoBeInterfaceEndpointCreate: {
-                            description: "Request to create a new endpoint.\n\nUse this when you identify a missing endpoint that should exist based on\nrequirements analysis. Common scenarios:\n\n- A required operation was accidentally omitted from initial generation\n- A use case requires an endpoint that wasn't initially identified\n- Review reveals gaps in API coverage for specific requirements",
+                            description: "Add a missing endpoint.",
                             type: "object",
                             properties: {
                                 reason: {
-                                    description: "Reason for creating this endpoint.\n\nExplain which requirement this endpoint fulfills and why it was missing\nfrom the initial generation.",
+                                    description: "Why this endpoint is needed.",
                                     type: "string"
                                 },
                                 type: {
-                                    description: "Type discriminator indicating this is a create operation.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "create"
@@ -1228,15 +1227,15 @@ const createController = (props) => {
                             ]
                         },
                         AutoBeInterfaceEndpointDesign: {
-                            description: "Endpoint design with description and specification.\n\nRepresents a single endpoint generated during the write phase, pairing the\nendpoint definition (path + method) with a description of its purpose.\n\nThis type formalizes the legacy\n`IAutoBeInterfaceEndpointWriteApplication.IContent` structure for reuse\nacross the codebase. The description provides business context that helps:\n\n- Review agents validate that the endpoint fulfills actual requirements\n- Operation generation create appropriate request/response schemas\n- Schema design infer correct data structures",
+                            description: "Endpoint design with description, authorization, and endpoint definition.",
                             type: "object",
                             properties: {
                                 description: {
-                                    description: "Description of what this endpoint does.\n\nFunctional description of the endpoint's purpose and business context.\nShould explain the use case and requirements this endpoint fulfills, not\njust repeat the path/method.\n\nWrite concisely. Keep it brief and to the point.",
+                                    description: "Functional description of what this endpoint does and why. Keep concise.",
                                     type: "string"
                                 },
                                 authorizationActors: {
-                                    description: "Authorization actors associated with this API endpoint.\n\nSpecify actors that are **associated with** this endpoint. An actor should\nbe included if:\n\n1. **The actor can call this endpoint**: The endpoint requires authentication\n   and only this actor type can access it.\n2. **The endpoint is related to the actor**: If the endpoint path contains the\n   actor name (e.g., `/auth/users/login` \u2192 `\"user\"`), or the endpoint\n   serves that actor type, include the actor to indicate the relationship.\n\n## Examples\n\n- `/auth/users/login` \u2192 `[\"user\"]` (related to user)\n- `/auth/admins/join` \u2192 `[\"admin\"]` (related to admin)\n- `/users/{userId}/profile` \u2192 `[\"user\"]` (user can call)\n- `/products` \u2192 `[]` (public, no association)\n\n## \u26A0\uFE0F Actor Multiplication Effect\n\nEach actor may generate a separate endpoint. Minimize actors to prevent\nendpoint explosion.\n\n## Naming Convention\n\nUse camelCase for all actor names (e.g., `\"user\"`, `\"admin\"`, `\"seller\"`).",
+                                    description: "Authorization actors associated with this endpoint (camelCase).\n\nInclude an actor if it can call this endpoint or the endpoint is\nsemantically related to it (e.g., `/auth/users/login` \u2192 `[\"user\"]`). Empty\narray for public endpoints.\n\nEach actor may generate a separate endpoint \u2014 minimize to prevent endpoint\nexplosion.",
                                     type: "array",
                                     items: {
                                         type: "string",
@@ -1245,7 +1244,7 @@ const createController = (props) => {
                                     }
                                 },
                                 authorizationType: {
-                                    description: "Authorization type of the API endpoint.\n\n- `\"login\"`: User login endpoint that validates credentials\n- `\"join\"`: User registration endpoint that creates accounts\n- `\"withdraw\"`: User withdrawal/deactivation endpoint that deletes accounts\n- `\"refresh\"`: Token refresh endpoint that renews access tokens\n- `\"session\"`: Session related endpoint (e.g., logout, session management)\n- `\"password\"`: Password related endpoint (e.g., reset, change password)\n- `\"management\"`: Authentication-related endpoint other than above types\n  (e.g., email/phone verification, 2FA, OAuth, profile update)\n- `null`: All other endpoints (CRUD, business logic, etc.)",
+                                    description: "Authorization type of the endpoint.\n\n- `\"login\"`: Credential validation\n- `\"join\"`: Account registration\n- `\"withdraw\"`: Account deactivation\n- `\"refresh\"`: Token renewal\n- `\"session\"`: Session management (logout, etc.)\n- `\"password\"`: Password reset/change\n- `\"management\"`: Other auth-related (2FA, OAuth, verification)\n- `null`: All other endpoints",
                                     anyOf: [
                                         {
                                             type: "string",
@@ -1277,19 +1276,19 @@ const createController = (props) => {
                             ]
                         },
                         AutoBeInterfaceEndpointErase: {
-                            description: "Request to erase an endpoint.\n\nUse this when an endpoint should be removed from the generated set:\n\n- Duplicate functionality with another endpoint\n- Not derived from actual requirements (hallucinated)\n- Violates RESTful conventions or business rules\n- Security concern (exposes sensitive data inappropriately)\n- Over-engineering (unnecessary granularity)",
+                            description: "Remove an invalid or duplicate endpoint.",
                             type: "object",
                             properties: {
                                 reason: {
-                                    description: "Reason for deletion.\n\nExplain why this endpoint should be removed and what issue it causes.",
+                                    description: "Why this endpoint should be removed.",
                                     type: "string"
                                 },
                                 endpoint: {
-                                    description: "The endpoint to remove.\n\n\u26A0\uFE0F CRITICAL: Must be from the \"Endpoints for Review\" list provided above.\nDO NOT reference endpoints that are not in the provided list. Must match\nexactly (path + method).",
+                                    description: "Endpoint to remove. MUST match exactly (path + method) from the provided\nreview list.",
                                     $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
                                 },
                                 type: {
-                                    description: "Type discriminator indicating this is an erase operation.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "erase"
@@ -1303,19 +1302,19 @@ const createController = (props) => {
                             ]
                         },
                         AutoBeInterfaceEndpointKeep: {
-                            description: "Request to keep an endpoint unchanged.\n\nUse this to explicitly approve an endpoint that is correctly designed. Every\nendpoint in the review list MUST have a corresponding revision - use `keep`\nfor endpoints that need no changes rather than omitting them.\n\nThis explicit approval ensures:\n\n- Complete review coverage (no endpoints are accidentally skipped)\n- Documented reasoning for why the endpoint is correct\n- Audit trail of review decisions",
+                            description: "Approve an endpoint as correctly designed.\n\nEvery endpoint in the review list MUST have a revision \u2014 use `keep` for\ncorrect ones rather than omitting them.",
                             type: "object",
                             properties: {
                                 reason: {
-                                    description: "Reason for keeping this endpoint unchanged.\n\nBriefly explain why this endpoint is correctly designed and needs no\nmodification. This documents the review decision.",
+                                    description: "Why this endpoint is correct and needs no changes.",
                                     type: "string"
                                 },
                                 endpoint: {
-                                    description: "The endpoint to keep unchanged.\n\n\u26A0\uFE0F CRITICAL: Must be from the \"Endpoints for Review\" list provided above.\nDO NOT reference endpoints that are not in the provided list. Must match\nexactly (path + method).",
+                                    description: "Endpoint to keep. MUST match exactly (path + method) from the provided\nreview list.",
                                     $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
                                 },
                                 type: {
-                                    description: "Type discriminator indicating this is a keep operation.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "keep"
@@ -1329,26 +1328,26 @@ const createController = (props) => {
                             ]
                         },
                         AutoBeInterfaceEndpointUpdate: {
-                            description: "Request to update an existing endpoint.\n\nUse this when an endpoint has issues that need correction:\n\n- Path naming inconsistency (e.g., `/userProfile` vs `/users/{userId}/profile`)\n- Incorrect HTTP method (e.g., GET for mutation operations)\n- Path structure needs adjustment (e.g., hierarchical nesting)\n- Parameter naming issues (e.g., `{id}` \u2192 `{userId}`)\n- Singular/plural normalization (e.g., `/user` \u2192 `/users`)",
+                            description: "Fix an incorrectly structured endpoint (path/method corrections).",
                             type: "object",
                             properties: {
                                 reason: {
-                                    description: "Reason for this update.\n\nExplain what issue this fixes and why the new definition is better.",
+                                    description: "Why this fix is needed.",
                                     type: "string"
                                 },
                                 endpoint: {
-                                    description: "The original endpoint to modify.\n\n\u26A0\uFE0F CRITICAL: Must be from the \"Endpoints for Review\" list provided above.\nDO NOT reference endpoints that are not in the provided list. Must match\nexactly (path + method).",
+                                    description: "Original endpoint to modify. MUST match exactly (path + method) from the\nprovided review list.",
                                     $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
                                 },
                                 type: {
-                                    description: "Type discriminator indicating this is an update operation.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "update"
                                     ]
                                 },
                                 newDesign: {
-                                    description: "The updated endpoint definition.\n\nContains the corrected path and/or method.",
+                                    description: "Corrected endpoint definition.",
                                     $ref: "#/$defs/AutoBeInterfaceEndpointDesign"
                                 }
                             },
@@ -1361,7 +1360,7 @@ const createController = (props) => {
                         }
                     }
                 },
-                description: "Process endpoint review task or preliminary data requests.\n\nReviews and validates generated endpoints to ensure they meet quality\nstandards. The review process examines endpoint design, identifies issues\nsuch as duplicates or inconsistencies, and applies corrections through\nrevision operations (keep, create, update, or erase).\n\n**Critical**: Every endpoint in the provided list MUST receive a revision\ndecision. No omissions are allowed - use \"keep\" to explicitly approve\nendpoints that need no changes.",
+                description: "Process task or retrieve preliminary data. Every endpoint MUST receive a\nrevision decision.",
                 validate: (() => { const _io0 = input => "string" === typeof input.thinking && ("object" === typeof input.request && null !== input.request && _iu1(input.request)); const _io1 = input => "getAnalysisSections" === input.type && (Array.isArray(input.sectionIds) && (1 <= input.sectionIds.length && input.sectionIds.length <= 100 && input.sectionIds.every(elem => "number" === typeof elem && __typia_transform__isTypeUint32._isTypeUint32(elem)))); const _io2 = input => "getDatabaseSchemas" === input.type && (Array.isArray(input.schemaNames) && (1 <= input.schemaNames.length && input.schemaNames.every(elem => "string" === typeof elem))); const _io3 = input => "getPreviousAnalysisSections" === input.type && (Array.isArray(input.sectionIds) && (1 <= input.sectionIds.length && input.sectionIds.every(elem => "number" === typeof elem && __typia_transform__isTypeUint32._isTypeUint32(elem)))); const _io4 = input => "getPreviousDatabaseSchemas" === input.type && (Array.isArray(input.schemaNames) && (1 <= input.schemaNames.length && input.schemaNames.every(elem => "string" === typeof elem))); const _io5 = input => "getPreviousInterfaceOperations" === input.type && (Array.isArray(input.endpoints) && (1 <= input.endpoints.length && input.endpoints.every(elem => "object" === typeof elem && null !== elem && _io6(elem)))); const _io6 = 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 _io7 = input => "complete" === input.type && "string" === typeof input.review && (Array.isArray(input.revises) && input.revises.every(elem => "object" === typeof elem && null !== elem && _iu0(elem))); const _io8 = input => "string" === typeof input.reason && "create" === input.type && ("object" === typeof input.design && null !== input.design && _io9(input.design)); const _io9 = input => "string" === typeof input.description && (Array.isArray(input.authorizationActors) && input.authorizationActors.every(elem => "string" === typeof elem && (RegExp("^[a-z][a-zA-Z0-9]*$").test(elem) && 1 <= elem.length))) && (null === input.authorizationType || "login" === input.authorizationType || "join" === input.authorizationType || "refresh" === input.authorizationType || "password" === input.authorizationType || "session" === input.authorizationType || "withdraw" === input.authorizationType || "management" === input.authorizationType) && ("object" === typeof input.endpoint && null !== input.endpoint && _io6(input.endpoint)); const _io10 = input => "string" === typeof input.reason && ("object" === typeof input.endpoint && null !== input.endpoint && _io6(input.endpoint)) && "erase" === input.type; const _io11 = input => "string" === typeof input.reason && ("object" === typeof input.endpoint && null !== input.endpoint && _io6(input.endpoint)) && "keep" === input.type; const _io12 = input => "string" === typeof input.reason && ("object" === typeof input.endpoint && null !== input.endpoint && _io6(input.endpoint)) && "update" === input.type && ("object" === typeof input.newDesign && null !== input.newDesign && _io9(input.newDesign)); const _iu0 = input => (() => {
                     if ("create" === input.type)
                         return _io8(input);