@autobe/agent 0.30.4-dev.20260324 → 0.30.5

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations.d.ts

@@ -1,100 +1,17 @@
 import { AutoBeOpenApi } from "@autobe/interface";
 import { tags } from "typia";
 /**
- * Request to retrieve interface operations from a previous version.
+ * Request to retrieve interface operations from the previous iteration.
  *
- * This type is used to load API operation definitions that were generated in a
- * **previous version** of the AutoBE generation pipeline. This is NOT about
- * re-requesting operations within the same execution, but rather accessing
- * artifacts from an earlier version.
- *
- * **Use Case:** When regenerating or modifying API operations based on user
- * change requests, agents need to reference the previously generated operations
- * to understand the existing API design and what needs to be modified.
- *
- * **Key Difference from `getInterfaceOperations`:**
- *
- * - `getInterfaceOperations`: Fetches operations from the **current version**
- *   (the version being generated right now)
- * - `getPreviousInterfaceOperations`: Fetches operations from the **previous
- *   version** (the last successfully generated version)
- *
- * **Example Scenario:**
- *
- *     Initial generation:
- *     - INTERFACE phase creates: GET /users, POST /users, GET /users/{id}
- *     - Generation completes successfully
- *
- *     User: "Change user creation to require email verification"
- *
- *     Regeneration:
- *     - INTERFACE phase starts regeneration
- *     - Calls getPreviousInterfaceOperations([{method: "POST", path: "/users"}])
- *       → Loads the previous version of POST /users operation
- *     - Creates new version with emailVerification requirement in request body
- *
- * **Automatic Schema Loading:**
- *
- * When operations are loaded from the previous version, their associated
- * request/response body schemas are also referenced, providing complete context
- * for understanding the operation's data structures.
- *
- * **Waterfall + Spiral Pattern:**
- *
- * This aligns with AutoBE's regeneration cycles where:
- *
- * - Compilation failures trigger regeneration with corrections
- * - User modifications trigger new versions
- * - Previous operations serve as reference for incremental API changes
- *
- * @author Samchon
+ * Loads API operation definitions from the last successfully generated version,
+ * used as reference context during regeneration or modification cycles.
  */
 export interface IAutoBePreliminaryGetPreviousInterfaceOperations {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getPreviousInterfaceOperations" indicates this is a
-     * preliminary data request for interface operations from a previous version.
-     */
+    /** Type discriminator. */
     type: "getPreviousInterfaceOperations";
     /**
-     * List of API operation endpoints to retrieve from the previous version.
-     *
-     * These are endpoint identifiers (method + path) that were generated in a
-     * previous version and are needed as reference context for the current
-     * regeneration.
-     *
-     * **Important Notes:**
-     *
-     * - These endpoints MUST exist in the previous version
-     * - This function is only available when a previous version exists
-     * - Used for reference/comparison, not for re-requesting within same execution
-     * - Each endpoint is identified by: `{method: "GET|POST|PUT|DELETE|PATCH",
-     *   path: "/api/path"}`
-     *
-     * **When This Function is Available:**
-     *
-     * - When a previous version exists
-     * - When user requests modifications to existing API operations
-     * - During correction/regeneration cycles that need previous operation context
-     *
-     * **When This Function is NOT Available:**
-     *
-     * - During initial generation (no previous version exists)
-     * - No previous interface operations available for this orchestration task
-     *
-     * **Endpoint Format:**
-     *
-     * - Method: HTTP verb in uppercase (e.g., "GET", "POST", "PUT", "DELETE",
-     *   "PATCH")
-     * - Path: OpenAPI path with parameters (e.g., "/users/{id}", "/posts")
-     *
-     * **Example Endpoints:**
-     *
-     * - `{method: "GET", path: "/users/{id}"}`
-     * - `{method: "POST", path: "/shoppings/orders"}`
-     * - `{method: "PATCH", path: "/bbs/articles"}`
+     * Endpoints to retrieve from previous iteration. DO NOT request same
+     * endpoints already requested in previous calls.
      */
     endpoints: AutoBeOpenApi.IEndpoint[] & tags.MinItems<1>;
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetPreviousInterfaceSchemas.d.ts

@@ -1,103 +1,17 @@
 import { tags } from "typia";
 /**
- * Request to retrieve interface schemas from a previous version.
+ * Request to retrieve interface schemas from the previous iteration.
  *
- * This type is used to load OpenAPI schema definitions (DTOs from
- * components.schemas) that were generated in a **previous version** of the
- * AutoBE generation pipeline. This is NOT about re-requesting schemas within
- * the same execution, but rather accessing artifacts from an earlier version.
- *
- * **Use Case:** When regenerating or modifying API schemas based on user change
- * requests, agents need to reference the previously generated schemas to
- * understand the existing DTO structure and what needs to be modified.
- *
- * **Key Difference from `getInterfaceSchemas`:**
- *
- * - `getInterfaceSchemas`: Fetches schemas from the **current version** (the
- *   version being generated right now)
- * - `getPreviousInterfaceSchemas`: Fetches schemas from the **previous version**
- *   (the last successfully generated version)
- *
- * **Example Scenario:**
- *
- *     Initial generation:
- *     - INTERFACE phase creates: IUser, IUser.ICreate, IUser.IUpdate, IPost
- *     - Generation completes successfully
- *
- *     User: "Add phone number to user profile"
- *
- *     Regeneration:
- *     - INTERFACE phase starts regeneration
- *     - Calls getPreviousInterfaceSchemas(["IUser", "IUser.IUpdate"])
- *       → Loads the previous versions of these schemas
- *     - Creates new versions with phoneNumber property added
- *
- * **Automatic Dependency Loading:**
- *
- * When schemas are loaded from the previous version, their referenced schemas
- * (via `$ref`) are also available, providing complete type dependency context
- * for understanding the schema structure.
- *
- * **Schema Type Naming Convention:**
- *
- * - Entity schemas: `IEntityName` (e.g., "IUser", "IPost", "IShoppingSale")
- * - Nested DTOs: `IEntityName.ISubType` (e.g., "IUser.ICreate", "IPost.IUpdate")
- * - Response wrappers: `IPage<IEntityName>` (e.g., "IPageIUser", "IPageIPost")
- * - Summary types: `IEntityName.ISummary` (e.g., "IBbsArticle.ISummary")
- * - Authorized types: `IEntityName.IAuthorized` (e.g., "IUser.IAuthorized")
- *
- * **Waterfall + Spiral Pattern:**
- *
- * This aligns with AutoBE's regeneration cycles where:
- *
- * - Compilation failures trigger regeneration with corrections
- * - User modifications trigger new versions
- * - Previous schemas serve as reference for incremental DTO changes
- *
- * @author Samchon
+ * Loads OpenAPI schema definitions (DTOs) from the last successfully generated
+ * version, used as reference context during regeneration or modification
+ * cycles.
  */
 export interface IAutoBePreliminaryGetPreviousInterfaceSchemas {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getPreviousInterfaceSchemas" indicates this is a
-     * preliminary data request for interface schemas from a previous version.
-     */
+    /** Type discriminator. */
     type: "getPreviousInterfaceSchemas";
     /**
-     * List of schema type names to retrieve from the previous version.
-     *
-     * These are type names from the OpenAPI components.schemas section that were
-     * generated in a previous version and are needed as reference context for the
-     * current regeneration.
-     *
-     * **Important Notes:**
-     *
-     * - These type names MUST exist in the previous version
-     * - This function is only available when a previous version exists
-     * - Used for reference/comparison, not for re-requesting within same execution
-     * - Type names follow TypeScript interface naming (e.g., "IUser",
-     *   "IUser.ICreate")
-     *
-     * **When This Function is Available:**
-     *
-     * - When a previous version exists
-     * - When user requests modifications to existing API schemas
-     * - During correction/regeneration cycles that need previous schema context
-     *
-     * **When This Function is NOT Available:**
-     *
-     * - During initial generation (no previous version exists)
-     * - No previous interface schemas available for this orchestration task
-     *
-     * **Type Name Examples:**
-     *
-     * - Base entity: "IShoppingSale", "IBbsArticle", "IUser"
-     * - Create DTO: "IShoppingSale.ICreate", "IBbsArticle.ICreate"
-     * - Update DTO: "IShoppingSale.IUpdate", "IUser.IUpdate"
-     * - Paginated: "IPageIShoppingSale", "IPageIBbsArticle"
-     * - Summary: "IShoppingSale.ISummary", "IBbsArticle.ISummary"
+     * Schema type names to retrieve from previous iteration. DO NOT request same
+     * names already requested in previous calls.
      */
     typeNames: string[] & tags.MinItems<1>;
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetRealizeCollectors.d.ts

@@ -1,29 +1,10 @@
 import { tags } from "typia";
-/**
- * Request to retrieve Realize Collector function definitions for context.
- *
- * This type is used in the preliminary phase to request specific collector
- * functions generated during the REALIZE_COLLECTOR_WRITE phase. Collectors
- * transform API request DTOs into database CreateInput structures.
- *
- * @author Samchon
- */
+/** Request to retrieve Realize Collector function definitions for context. */
 export interface IAutoBePreliminaryGetRealizeCollectors {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getRealizeCollectors" indicates this is a
-     * preliminary data request for collector functions.
-     */
+    /** Type discriminator. */
     type: "getRealizeCollectors";
     /**
-     * List of collector DTO type names to retrieve.
-     *
-     * DTO type names for Create DTOs that have collector functions (e.g.,
-     * "IShoppingSale.ICreate", "IBbsArticle.ICreate").
-     *
-     * CRITICAL: DO NOT request the same type names that you have already
+     * Collector DTO type names to retrieve. DO NOT request same names already
      * requested in previous calls.
      */
     dtoTypeNames: string[] & tags.MinItems<1>;

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetRealizeTransformers.d.ts

@@ -1,29 +1,10 @@
 import { tags } from "typia";
-/**
- * Request to retrieve Realize Transformer function definitions for context.
- *
- * This type is used in the preliminary phase to request specific transformer
- * functions generated during the REALIZE_TRANSFORMER_WRITE phase. Transformers
- * convert database query results into API response DTOs.
- *
- * @author Samchon
- */
+/** Request to retrieve Realize Transformer function definitions for context. */
 export interface IAutoBePreliminaryGetRealizeTransformers {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getRealizeTransformers" indicates this is a
-     * preliminary data request for transformer functions.
-     */
+    /** Type discriminator. */
     type: "getRealizeTransformers";
     /**
-     * List of transformer DTO type names to retrieve.
-     *
-     * DTO type names for response DTOs that have transformer functions (e.g.,
-     * "IShoppingSale", "IBbsArticle", "IShoppingSale.ISummary").
-     *
-     * CRITICAL: DO NOT request the same type names that you have already
+     * Transformer DTO type names to retrieve. DO NOT request same names already
      * requested in previous calls.
      */
     dtoTypeNames: string[] & tags.MinItems<1>;