@autobe/agent 0.30.4 → 0.30.5

package/lib/orchestrate/realize/orchestrateRealizeCollectorPlan.js

@@ -106,7 +106,7 @@ function process(ctx, props) {
                             properties: {
                                 thinking: {
                                     type: "string",
-                                    description: "Think before you act.\n\nBefore requesting preliminary data or completing your plan, reflect on\nyour current state and explain your reasoning:\n\nFor preliminary requests:\n\n- What schemas (database, DTO, Operations) are missing that you need?\n- Why do you need them for planning?\n- Be brief - state the gap, don't list everything you have.\n\nFor completion:\n\n- Is this DTO collectable or non-collectable?\n- What database table does it map to (if collectable)?\n- Why is it non-collectable (if applicable)?\n\nThis reflection helps you avoid duplicate requests and premature\ncompletion."
+                                    description: "Think before you act.\n\nFor preliminary requests: what schemas (database, DTO, operations) are\nmissing?\n\nFor completion: is this DTO collectable or non-collectable? What database\ntable does it map to (if collectable)?"
                                 },
                                 request: {
                                     oneOf: [
@@ -136,7 +136,7 @@ function process(ctx, props) {
                                             complete: "#/components/schemas/IAutoBeRealizeCollectorPlanApplication.IComplete"
                                         }
                                     },
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform:\n\n- \"getDatabaseSchemas\": Retrieve database table schemas for DB structure\n- \"getAnalysisSections\": Retrieve analysis sections for context\n- \"getInterfaceOperations\": Retrieve operation specifications\n- \"getInterfaceSchemas\": Retrieve DTO type definitions for API contracts\n- \"complete\": Generate final collector plan\n\nThe preliminary types are removed from the union after their respective\ndata has been provided, physically preventing repeated calls."
+                                    description: "Action to perform. Exhausted preliminary types are removed from the\nunion, physically preventing repeated calls."
                                 }
                             },
                             required: [
@@ -149,7 +149,7 @@ function process(ctx, props) {
                             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",
@@ -159,21 +159,21 @@ function process(ctx, props) {
                                     },
                                     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",
@@ -181,21 +181,21 @@ function process(ctx, props) {
                                         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."
                         },
                         IAutoBePreliminaryGetInterfaceOperations: {
                             type: "object",
                             properties: {
                                 type: {
                                     "const": "getInterfaceOperations",
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getInterfaceOperations\" indicates this is a\npreliminary data request for interface operations."
+                                    description: "Type discriminator."
                                 },
                                 endpoints: {
                                     type: "array",
@@ -203,14 +203,14 @@ function process(ctx, props) {
                                         $ref: "#/components/schemas/AutoBeOpenApi.IEndpoint"
                                     },
                                     minItems: 1,
-                                    description: "List of existing API operation endpoints to retrieve.\n\nOperations that have been generated in previous phases, containing paths,\nmethods, parameters, and request/response bodies.\n\nCRITICAL: DO NOT request the same endpoints that you have already requested\nin previous calls."
+                                    description: "API operation endpoints to retrieve. DO NOT request same endpoints already\nrequested in previous calls."
                                 }
                             },
                             required: [
                                 "type",
                                 "endpoints"
                             ],
-                            description: "Request to retrieve existing interface operations for context.\n\nThis type is used in the preliminary phase to request already-generated API\noperations for review, validation, or complementary generation tasks."
+                            description: "Request to retrieve existing interface operations for context."
                         },
                         "AutoBeOpenApi.IEndpoint": {
                             type: "object",
@@ -218,7 +218,7 @@ function process(ctx, props) {
                                 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: [
@@ -238,7 +238,7 @@ function process(ctx, props) {
                                             "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: [
@@ -252,7 +252,7 @@ function process(ctx, props) {
                             properties: {
                                 type: {
                                     "const": "getInterfaceSchemas",
-                                    description: "Type discriminator for the request.\n\nDetermines which action to perform: preliminary data retrieval or actual\ntask execution. Value \"getInterfaceSchemas\" indicates this is a preliminary\ndata request for interface schemas."
+                                    description: "Type discriminator."
                                 },
                                 typeNames: {
                                     type: "array",
@@ -260,14 +260,14 @@ function process(ctx, props) {
                                         type: "string"
                                     },
                                     minItems: 1,
-                                    description: "List of schema type names to retrieve.\n\nSchema names from the OpenAPI components.schemas section (e.g., \"IUser\",\n\"IUser.ICreate\", \"IPost.IUpdate\").\n\nCRITICAL: DO NOT request the same type names that you have already\nrequested in previous calls."
+                                    description: "Schema type names to retrieve. DO NOT request same names already requested\nin previous calls."
                                 }
                             },
                             required: [
                                 "type",
                                 "typeNames"
                             ],
-                            description: "Request to retrieve OpenAPI schema type definitions for context.\n\nThis type is used in the preliminary phase to request specific schema\ndefinitions from components.schemas for review or complementary generation."
+                            description: "Request to retrieve OpenAPI schema type definitions for context."
                         },
                         "IAutoBeRealizeCollectorPlanApplication.IComplete": {
                             type: "object",
@@ -281,25 +281,25 @@ function process(ctx, props) {
                                     items: {
                                         $ref: "#/components/schemas/IAutoBeRealizeCollectorPlanApplication.IPlan"
                                     },
-                                    description: "Plan entry for the given DTO.\n\nMust contain exactly ONE entry with:\n\n- DTO type name matching the given DTO\n- Chain of thought explaining the analysis\n- Database schema name if collectable, or null if not\n\nUse databaseSchemaName to distinguish:\n\n- Non-null: Collectable DTO, collector will be generated\n- Null: Non-collectable DTO, no collector needed"
+                                    description: "Exactly ONE entry. databaseSchemaName non-null = collectable, null = no\ncollector needed."
                                 }
                             },
                             required: [
                                 "type",
                                 "plans"
                             ],
-                            description: "Request to complete collector planning.\n\nGenerates a plan with exactly ONE entry for the given DTO, indicating\nwhether it is collectable (has database schema name) or non-collectable\n(null)."
+                            description: "Generates exactly ONE plan entry indicating collectable (has DB schema\nname) or not (null)."
                         },
                         "IAutoBeRealizeCollectorPlanApplication.IPlan": {
                             type: "object",
                             properties: {
                                 dtoTypeName: {
                                     type: "string",
-                                    description: "DTO type name being analyzed.\n\nThe TypeScript interface type from the operation request body.\n\nExample: \"IShoppingSale.ICreate\", \"IShoppingCategory.ICreate\""
+                                    description: "TypeScript interface type from the operation request body (e.g.,\n\"IShoppingSale.ICreate\")."
                                 },
                                 thinking: {
                                     type: "string",
-                                    description: "Chain of thought for this DTO's planning decision.\n\nExplains the agent's reasoning:\n\n- For collectable DTOs: Why a collector is needed, which database table it\n  maps to\n- For non-collectable DTOs: Why no collector is needed (read-only DTO,\n  computed type, etc.)\n\nExample (collectable): \"Collects IShoppingSale.ICreate to shopping_sales\nwith nested category\"\n\nExample (non-collectable): \"IShoppingSale is read-only response DTO, not\nfor creation\""
+                                    description: "Reasoning for this DTO's planning decision.\n\nCollectable: \"Collects IShoppingSale.ICreate to shopping_sales with\nnested category\".\n\nNon-collectable: \"IShoppingSale is read-only response DTO, not for\ncreation\"."
                                 },
                                 databaseSchemaName: {
                                     oneOf: [
@@ -310,14 +310,14 @@ function process(ctx, props) {
                                             type: "string"
                                         }
                                     ],
-                                    description: "Database schema name if collectable, null if not.\n\n- **Non-null**: The database table name this DTO maps to. A collector will\n  be generated for this DTO.\n- **Null**: This DTO is non-collectable (read-only DTO, computed type). No\n  collector will be generated.\n\nExamples:\n\n- (collectable): \"shopping_sales\", \"shopping_categories\"\n- (non-collectable): null"
+                                    description: "Database table name if collectable (e.g., \"shopping_sales\"), null if\nnon-collectable (read-only DTO, computed type)."
                                 },
                                 references: {
                                     type: "array",
                                     items: {
                                         $ref: "#/components/schemas/AutoBeRealizeCollectorReference"
                                     },
-                                    description: "Referenced entities from path parameters or auth context.\n\nEach reference contains:\n\n- `databaseSchemaName`: Database table name (e.g., \"shopping_sales\")\n- `source`: Origin of reference\n\n  - \"from path parameter {paramName}\"\n  - \"from authorized actor\"\n  - \"from authorized session\"\n\nSee `AutoBeRealizeCollectorReference` for details.\n\nEmpty array means the Create DTO contains all necessary references."
+                                    description: "Referenced entities from path parameters or auth context.\n\nEach reference contains `databaseSchemaName` and `source` (e.g., \"from\npath parameter {id}\", \"from authorized actor\"). Empty array means the\nCreate DTO contains all necessary references."
                                 }
                             },
                             required: [
@@ -326,25 +326,25 @@ function process(ctx, props) {
                                 "databaseSchemaName",
                                 "references"
                             ],
-                            description: "Plan for a single DTO analysis result.\n\nRecords the planning decision for one DTO from the operation request."
+                            description: "Planning decision for one DTO."
                         },
                         AutoBeRealizeCollectorReference: {
                             type: "object",
                             properties: {
                                 databaseSchemaName: {
                                     type: "string",
-                                    description: "Prisma schema name (table name) of the referenced entity.\n\nExamples: \"shopping_sales\", \"shopping_customers\", \"bbs_members\""
+                                    description: "Prisma table name (e.g., \"shopping_sales\", \"shopping_customers\")."
                                 },
                                 source: {
                                     type: "string",
-                                    description: "Source of this reference, describing where it originates.\n\nPossible formats:\n\n- \"from path parameter {paramName}\" - URL path parameter (e.g., \"from path\n  parameter saleId\")\n- \"from authorized actor\" - Logged-in user entity\n- \"from authorized session\" - Current user session entity"
+                                    description: "Source of this reference:\n\n- \"from path parameter {paramName}\" \u2014 URL path parameter\n- \"from authorized actor\" \u2014 logged-in user entity\n- \"from authorized session\" \u2014 current session entity"
                                 }
                             },
                             required: [
                                 "databaseSchemaName",
                                 "source"
                             ],
-                            description: "Reference to an external entity needed by a collector function.\n\nWhen a Create DTO doesn't contain all foreign key references needed to create\nthe Prisma record, those references come from either path parameters or auth\ncontext. This interface tracks both the Prisma schema name and the source of\nthe reference.\n\nThe source field indicates where the reference originates:\n\n- \"from path parameter X\" - Entity identifier from URL path (e.g., saleId)\n- \"from authorized actor\" - Logged-in user entity (customer/seller/member)\n- \"from authorized session\" - Current user session entity\n\nEach reference becomes an `IEntity` parameter in the collector's `collect()`\nfunction signature."
+                            description: "External entity reference needed by a collector function.\n\nFK references not in the Create DTO come from path parameters or auth\ncontext. Each becomes an `IEntity` parameter in the collector's `collect()`\nsignature."
                         }
                     }
                 },
@@ -362,7 +362,7 @@ function process(ctx, props) {
                                 }
                             }
                         ],
-                        description: "Process collector planning task or preliminary data requests.\n\nAnalyzes the given DTO type and generates a plan entry determining whether\na collector is needed. Returns exactly ONE plan entry for the given DTO."
+                        description: "Analyzes the given DTO type and generates a plan entry determining whether\na collector is needed. Returns exactly ONE plan entry."
                     }
                 ]
             },
@@ -711,11 +711,11 @@ function createController(props) {
                     type: "object",
                     properties: {
                         thinking: {
-                            description: "Think before you act.\n\nBefore requesting preliminary data or completing your plan, reflect on\nyour current state and explain your reasoning:\n\nFor preliminary requests:\n\n- What schemas (database, DTO, Operations) are missing that you need?\n- Why do you need them for planning?\n- Be brief - state the gap, don't list everything you have.\n\nFor completion:\n\n- Is this DTO collectable or non-collectable?\n- What database table does it map to (if collectable)?\n- Why is it non-collectable (if applicable)?\n\nThis reflection helps you avoid duplicate requests and premature\ncompletion.",
+                            description: "Think before you act.\n\nFor preliminary requests: what schemas (database, DTO, operations) are\nmissing?\n\nFor completion: is this DTO collectable or non-collectable? What database\ntable does it map to (if collectable)?",
                             type: "string"
                         },
                         request: {
-                            description: "Type discriminator for the request.\n\nDetermines which action to perform:\n\n- \"getDatabaseSchemas\": Retrieve database table schemas for DB structure\n- \"getAnalysisSections\": Retrieve analysis sections for context\n- \"getInterfaceOperations\": Retrieve operation specifications\n- \"getInterfaceSchemas\": Retrieve DTO type definitions for API contracts\n- \"complete\": Generate final collector plan\n\nThe preliminary types are removed from the union after their respective\ndata has been provided, physically preventing repeated calls.",
+                            description: "Action to perform. Exhausted preliminary types are removed from the\nunion, physically preventing repeated calls.",
                             anyOf: [
                                 {
                                     $ref: "#/$defs/IAutoBePreliminaryGetAnalysisSections"
@@ -752,18 +752,18 @@ function 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",
@@ -779,18 +779,18 @@ function 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"
@@ -804,18 +804,18 @@ function createController(props) {
                             ]
                         },
                         IAutoBePreliminaryGetInterfaceOperations: {
-                            description: "Request to retrieve existing interface operations for context.\n\nThis type is used in the preliminary phase to request already-generated API\noperations for review, validation, or complementary generation tasks.",
+                            description: "Request to retrieve existing interface operations 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 \"getInterfaceOperations\" indicates this is a\npreliminary data request for interface operations.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getInterfaceOperations"
                                     ]
                                 },
                                 endpoints: {
-                                    description: "List of existing API operation endpoints to retrieve.\n\nOperations that have been generated in previous phases, containing paths,\nmethods, parameters, and request/response bodies.\n\nCRITICAL: DO NOT request the same endpoints that you have already requested\nin previous calls.",
+                                    description: "API operation endpoints to retrieve. DO NOT request same endpoints already\nrequested in previous calls.",
                                     type: "array",
                                     items: {
                                         $ref: "#/$defs/AutoBeOpenApi.IEndpoint"
@@ -833,12 +833,12 @@ function 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",
@@ -855,18 +855,18 @@ function createController(props) {
                             ]
                         },
                         IAutoBePreliminaryGetInterfaceSchemas: {
-                            description: "Request to retrieve OpenAPI schema type definitions for context.\n\nThis type is used in the preliminary phase to request specific schema\ndefinitions from components.schemas for review or complementary generation.",
+                            description: "Request to retrieve OpenAPI schema type 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 \"getInterfaceSchemas\" indicates this is a preliminary\ndata request for interface schemas.",
+                                    description: "Type discriminator.",
                                     type: "string",
                                     "enum": [
                                         "getInterfaceSchemas"
                                     ]
                                 },
                                 typeNames: {
-                                    description: "List of schema type names to retrieve.\n\nSchema names from the OpenAPI components.schemas section (e.g., \"IUser\",\n\"IUser.ICreate\", \"IPost.IUpdate\").\n\nCRITICAL: DO NOT request the same type names that you have already\nrequested in previous calls.",
+                                    description: "Schema type names to retrieve. DO NOT request same names already requested\nin previous calls.",
                                     type: "array",
                                     items: {
                                         type: "string"
@@ -880,7 +880,7 @@ function createController(props) {
                             ]
                         },
                         "IAutoBeRealizeCollectorPlanApplication.IComplete": {
-                            description: "Request to complete collector planning.\n\nGenerates a plan with exactly ONE entry for the given DTO, indicating\nwhether it is collectable (has database schema name) or non-collectable\n(null).",
+                            description: "Generates exactly ONE plan entry indicating collectable (has DB schema\nname) or not (null).",
                             type: "object",
                             properties: {
                                 type: {
@@ -891,7 +891,7 @@ function createController(props) {
                                     ]
                                 },
                                 plans: {
-                                    description: "Plan entry for the given DTO.\n\nMust contain exactly ONE entry with:\n\n- DTO type name matching the given DTO\n- Chain of thought explaining the analysis\n- Database schema name if collectable, or null if not\n\nUse databaseSchemaName to distinguish:\n\n- Non-null: Collectable DTO, collector will be generated\n- Null: Non-collectable DTO, no collector needed",
+                                    description: "Exactly ONE entry. databaseSchemaName non-null = collectable, null = no\ncollector needed.",
                                     type: "array",
                                     items: {
                                         $ref: "#/$defs/IAutoBeRealizeCollectorPlanApplication.IPlan"
@@ -904,19 +904,19 @@ function createController(props) {
                             ]
                         },
                         "IAutoBeRealizeCollectorPlanApplication.IPlan": {
-                            description: "Plan for a single DTO analysis result.\n\nRecords the planning decision for one DTO from the operation request.",
+                            description: "Planning decision for one DTO.",
                             type: "object",
                             properties: {
                                 dtoTypeName: {
-                                    description: "DTO type name being analyzed.\n\nThe TypeScript interface type from the operation request body.\n\nExample: \"IShoppingSale.ICreate\", \"IShoppingCategory.ICreate\"",
+                                    description: "TypeScript interface type from the operation request body (e.g.,\n\"IShoppingSale.ICreate\").",
                                     type: "string"
                                 },
                                 thinking: {
-                                    description: "Chain of thought for this DTO's planning decision.\n\nExplains the agent's reasoning:\n\n- For collectable DTOs: Why a collector is needed, which database table it\n  maps to\n- For non-collectable DTOs: Why no collector is needed (read-only DTO,\n  computed type, etc.)\n\nExample (collectable): \"Collects IShoppingSale.ICreate to shopping_sales\nwith nested category\"\n\nExample (non-collectable): \"IShoppingSale is read-only response DTO, not\nfor creation\"",
+                                    description: "Reasoning for this DTO's planning decision.\n\nCollectable: \"Collects IShoppingSale.ICreate to shopping_sales with\nnested category\".\n\nNon-collectable: \"IShoppingSale is read-only response DTO, not for\ncreation\".",
                                     type: "string"
                                 },
                                 databaseSchemaName: {
-                                    description: "Database schema name if collectable, null if not.\n\n- **Non-null**: The database table name this DTO maps to. A collector will\n  be generated for this DTO.\n- **Null**: This DTO is non-collectable (read-only DTO, computed type). No\n  collector will be generated.\n\nExamples:\n\n- (collectable): \"shopping_sales\", \"shopping_categories\"\n- (non-collectable): null",
+                                    description: "Database table name if collectable (e.g., \"shopping_sales\"), null if\nnon-collectable (read-only DTO, computed type).",
                                     anyOf: [
                                         {
                                             type: "null"
@@ -927,7 +927,7 @@ function createController(props) {
                                     ]
                                 },
                                 references: {
-                                    description: "Referenced entities from path parameters or auth context.\n\nEach reference contains:\n\n- `databaseSchemaName`: Database table name (e.g., \"shopping_sales\")\n- `source`: Origin of reference\n\n  - \"from path parameter {paramName}\"\n  - \"from authorized actor\"\n  - \"from authorized session\"\n\nSee `AutoBeRealizeCollectorReference` for details.\n\nEmpty array means the Create DTO contains all necessary references.",
+                                    description: "Referenced entities from path parameters or auth context.\n\nEach reference contains `databaseSchemaName` and `source` (e.g., \"from\npath parameter {id}\", \"from authorized actor\"). Empty array means the\nCreate DTO contains all necessary references.",
                                     type: "array",
                                     items: {
                                         $ref: "#/$defs/AutoBeRealizeCollectorReference"
@@ -942,15 +942,15 @@ function createController(props) {
                             ]
                         },
                         AutoBeRealizeCollectorReference: {
-                            description: "Reference to an external entity needed by a collector function.\n\nWhen a Create DTO doesn't contain all foreign key references needed to create\nthe Prisma record, those references come from either path parameters or auth\ncontext. This interface tracks both the Prisma schema name and the source of\nthe reference.\n\nThe source field indicates where the reference originates:\n\n- \"from path parameter X\" - Entity identifier from URL path (e.g., saleId)\n- \"from authorized actor\" - Logged-in user entity (customer/seller/member)\n- \"from authorized session\" - Current user session entity\n\nEach reference becomes an `IEntity` parameter in the collector's `collect()`\nfunction signature.",
+                            description: "External entity reference needed by a collector function.\n\nFK references not in the Create DTO come from path parameters or auth\ncontext. Each becomes an `IEntity` parameter in the collector's `collect()`\nsignature.",
                             type: "object",
                             properties: {
                                 databaseSchemaName: {
-                                    description: "Prisma schema name (table name) of the referenced entity.\n\nExamples: \"shopping_sales\", \"shopping_customers\", \"bbs_members\"",
+                                    description: "Prisma table name (e.g., \"shopping_sales\", \"shopping_customers\").",
                                     type: "string"
                                 },
                                 source: {
-                                    description: "Source of this reference, describing where it originates.\n\nPossible formats:\n\n- \"from path parameter {paramName}\" - URL path parameter (e.g., \"from path\n  parameter saleId\")\n- \"from authorized actor\" - Logged-in user entity\n- \"from authorized session\" - Current user session entity",
+                                    description: "Source of this reference:\n\n- \"from path parameter {paramName}\" \u2014 URL path parameter\n- \"from authorized actor\" \u2014 logged-in user entity\n- \"from authorized session\" \u2014 current session entity",
                                     type: "string"
                                 }
                             },
@@ -961,7 +961,7 @@ function createController(props) {
                         }
                     }
                 },
-                description: "Process collector planning task or preliminary data requests.\n\nAnalyzes the given DTO type and generates a plan entry determining whether\na collector is needed. Returns exactly ONE plan entry for the given DTO.",
+                description: "Analyzes the given DTO type and generates a plan entry determining whether\na collector is needed. Returns exactly ONE plan entry.",
                 validate: (() => { const _io0 = input => "string" === typeof input.thinking && ("object" === typeof input.request && null !== input.request && _iu0(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 => "getInterfaceOperations" === input.type && (Array.isArray(input.endpoints) && (1 <= input.endpoints.length && input.endpoints.every(elem => "object" === typeof elem && null !== elem && _io4(elem)))); const _io4 = 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 _io5 = input => "getInterfaceSchemas" === input.type && (Array.isArray(input.typeNames) && (1 <= input.typeNames.length && input.typeNames.every(elem => "string" === typeof elem))); const _io6 = input => "complete" === input.type && (Array.isArray(input.plans) && input.plans.every(elem => "object" === typeof elem && null !== elem && _io7(elem))); const _io7 = input => "string" === typeof input.dtoTypeName && "string" === typeof input.thinking && (null === input.databaseSchemaName || "string" === typeof input.databaseSchemaName) && (Array.isArray(input.references) && input.references.every(elem => "object" === typeof elem && null !== elem && _io8(elem))); const _io8 = input => "string" === typeof input.databaseSchemaName && "string" === typeof input.source; const _iu0 = input => (() => {
                     if ("getAnalysisSections" === input.type)
                         return _io1(input);