@autobe/agent 0.30.4-dev.20260324 → 0.30.5

package/src/orchestrate/common/structures/IAnalysisSectionEntry.ts

@@ -1,12 +1,6 @@
 /**
- * A single ### section extracted from an analysis file, enriched with parent
- * hierarchy context and numeric ID for LLM-friendly retrieval.
- *
- * Instead of loading entire analysis files (~110-120KB each), the preliminary
- * system can load individual sections (~200-600 words) identified by sequential
- * integer IDs.
- *
- * @author Juntak
+ * A single ### section extracted from an analysis file, with parent hierarchy
+ * context and numeric ID.
  */
 export interface IAnalysisSectionEntry {
   /**

package/src/orchestrate/common/structures/IAutoBeCommonCorrectCastingApplication.ts

@@ -1,72 +1,30 @@
 export interface IAutoBeCommonCorrectCastingApplication {
-  /**
-   * Rewrite function to fix severe syntax structure errors and type system
-   * errors.
-   *
-   * Called when detecting:
-   *
-   * - **Severe syntax errors**: Nested declarations in object literals, malformed
-   *   structures
-   * - **Type system errors**: Typia tags, Date conversions, nullable narrowing,
-   *   literal types
-   * - **Escape sequence errors**: Double backslashes in JSON context
-   *
-   * @param props The analysis and correction properties
-   */
+  /** Rewrite code to fix severe syntax structure or type system errors. */
   rewrite(props: IAutoBeCommonCorrectCastingApplication.IProps): void;
 
-  /**
-   * Reject function when error is outside scope.
-   *
-   * Called when error is unrelated (imports, undefined variables, business
-   * logic). These errors are handled by subsequent agents.
-   */
+  /** Reject when error is outside scope (handled by subsequent agents). */
   reject(): void;
 }
 export namespace IAutoBeCommonCorrectCastingApplication {
   export interface IProps {
-    /**
-     * Analysis of syntax structure or type system error.
-     *
-     * Identifies error pattern and chosen fix strategy:
-     *
-     * - Syntax: Nested declarations, malformed structures
-     * - Type: Tag incompatibility, nullable narrowing, Date conversions
-     */
+    /** Analysis of the error pattern and chosen fix strategy. */
     think: string;
 
-    /**
-     * Draft code with initial syntax/type fixes applied.
-     *
-     * After first correction round:
-     *
-     * - Syntax: Flattened declarations, restructured code
-     * - Type: Satisfies patterns, Date conversions, nullable checks
-     */
+    /** Draft code with initial syntax/type fixes applied. */
     draft: string;
 
-    /**
-     * Review and final code with all errors resolved.
-     *
-     * Review of applied fixes and final code ready for compilation.
-     */
+    /** Self-review pass that checks corrections and produces final code. */
     revise: IReviseProps;
   }
 
   export interface IReviseProps {
     /**
-     * Review of syntax/type correction patterns applied.
-     *
-     * Explains strategies used and confirms all errors resolved.
+     * Review of correction patterns applied and confirmation all errors
+     * resolved.
      */
     review: string;
 
-    /**
-     * Final corrected code ready for compilation.
-     *
-     * Code with all syntax/type errors fixed. Set to `null` when draft already
-     * resolves all issues with no further refinements needed.
-     */
+    /** Final corrected code, or `null` when draft already resolves all issues. */
     final: string | null;
   }
 }

package/src/orchestrate/common/structures/IAutoBePreliminaryCollection.ts

@@ -7,15 +7,7 @@ import {
 
 import { IAnalysisSectionEntry } from "./IAnalysisSectionEntry";
 
-/**
- * Complete data collection for preliminary RAG system.
- *
- * Used in both `all` (globally available) and `local` (currently loaded)
- * contexts of `AutoBePreliminaryController`. Contains current iteration data
- * and optional previous iteration data for complement cycles.
- *
- * @author Samchon
- */
+/** Complete data collection for the preliminary RAG system. */
 export interface IAutoBePreliminaryCollection {
   /** Individual ### sections from analysis files for fine-grained retrieval. */
   analysisSections: IAnalysisSectionEntry[];

package/src/orchestrate/common/structures/IAutoBePreliminaryGetAnalysisSections.ts

@@ -1,32 +1,13 @@
 import { tags } from "typia";
 
-/**
- * Request to retrieve individual analysis sections by numeric ID.
- *
- * Instead of loading entire analysis files (~110-120KB each), this loads
- * specific ### sections (~200-600 words each) identified by integer IDs from
- * the section catalog.
- *
- * @author Juntak
- */
+/** Request to retrieve individual analysis sections by numeric ID. */
 export interface IAutoBePreliminaryGetAnalysisSections {
-  /**
-   * Type discriminator for the request.
-   *
-   * Determines which action to perform: preliminary data retrieval or actual
-   * task execution. Value "getAnalysisSections" indicates this is a preliminary
-   * data request for individual analysis sections.
-   */
+  /** Type discriminator. */
   type: "getAnalysisSections";
 
   /**
-   * List of section IDs to retrieve.
-   *
-   * These are sequential integer IDs from the analysis sections catalog. Each
-   * ID maps to a specific ### section in the requirements documents.
-   *
-   * CRITICAL: DO NOT request the same section IDs that you have already
-   * requested in previous calls.
+   * Section IDs to retrieve. DO NOT request same IDs already requested in
+   * previous calls.
    */
   sectionIds: (number & tags.Type<"uint32">)[] &
     tags.MinItems<1> &

package/src/orchestrate/common/structures/IAutoBePreliminaryGetDatabaseSchemas.ts

@@ -1,30 +1,12 @@
 import { tags } from "typia";
 
-/**
- * Request to retrieve database schema definitions for context.
- *
- * This type is used in the preliminary phase to request specific database table
- * schemas needed for generating type-safe API operations.
- *
- * @author Samchon
- */
+/** Request to retrieve database schema definitions for context. */
 export interface IAutoBePreliminaryGetDatabaseSchemas {
-  /**
-   * Type discriminator for the request.
-   *
-   * Determines which action to perform: preliminary data retrieval or actual
-   * task execution. Value "getDatabaseSchemas" indicates this is a preliminary
-   * data request for database schemas.
-   */
+  /** Type discriminator. */
   type: "getDatabaseSchemas";
 
   /**
-   * List of database table names to retrieve.
-   *
-   * Table names from the database schema representing database entities (e.g.,
-   * "user", "post", "comment").
-   *
-   * CRITICAL: DO NOT request the same schema names that you have already
+   * Database table names to retrieve. DO NOT request same names already
    * requested in previous calls.
    */
   schemaNames: string[] & tags.MinItems<1>;

package/src/orchestrate/common/structures/IAutoBePreliminaryGetInterfaceOperations.ts

@@ -1,32 +1,14 @@
 import { AutoBeOpenApi } from "@autobe/interface";
 import { tags } from "typia";
 
-/**
- * Request to retrieve existing interface operations for context.
- *
- * This type is used in the preliminary phase to request already-generated API
- * operations for review, validation, or complementary generation tasks.
- *
- * @author Samchon
- */
+/** Request to retrieve existing interface operations for context. */
 export interface IAutoBePreliminaryGetInterfaceOperations {
-  /**
-   * Type discriminator for the request.
-   *
-   * Determines which action to perform: preliminary data retrieval or actual
-   * task execution. Value "getInterfaceOperations" indicates this is a
-   * preliminary data request for interface operations.
-   */
+  /** Type discriminator. */
   type: "getInterfaceOperations";
 
   /**
-   * List of existing API operation endpoints to retrieve.
-   *
-   * Operations that have been generated in previous phases, containing paths,
-   * methods, parameters, and request/response bodies.
-   *
-   * CRITICAL: DO NOT request the same endpoints that you have already requested
-   * in previous calls.
+   * API operation endpoints to retrieve. DO NOT request same endpoints already
+   * requested in previous calls.
    */
   endpoints: AutoBeOpenApi.IEndpoint[] & tags.MinItems<1>;
 }

package/src/orchestrate/common/structures/IAutoBePreliminaryGetInterfaceSchemas.ts

@@ -1,31 +1,13 @@
 import { tags } from "typia";
 
-/**
- * Request to retrieve OpenAPI schema type definitions for context.
- *
- * This type is used in the preliminary phase to request specific schema
- * definitions from components.schemas for review or complementary generation.
- *
- * @author Samchon
- */
+/** Request to retrieve OpenAPI schema type definitions for context. */
 export interface IAutoBePreliminaryGetInterfaceSchemas {
-  /**
-   * Type discriminator for the request.
-   *
-   * Determines which action to perform: preliminary data retrieval or actual
-   * task execution. Value "getInterfaceSchemas" indicates this is a preliminary
-   * data request for interface schemas.
-   */
+  /** Type discriminator. */
   type: "getInterfaceSchemas";
 
   /**
-   * List of schema type names to retrieve.
-   *
-   * Schema names from the OpenAPI components.schemas section (e.g., "IUser",
-   * "IUser.ICreate", "IPost.IUpdate").
-   *
-   * CRITICAL: DO NOT request the same type names that you have already
-   * requested in previous calls.
+   * Schema type names to retrieve. DO NOT request same names already requested
+   * in previous calls.
    */
   typeNames: string[] & tags.MinItems<1>;
 }

package/src/orchestrate/common/structures/IAutoBePreliminaryGetPreviousAnalysisSections.ts

@@ -1,28 +1,16 @@
 import { tags } from "typia";
 
 /**
- * Request to retrieve individual analysis sections from previous iteration by
- * numeric ID.
- *
- * Same as {@link IAutoBePreliminaryGetAnalysisSections} but for sections from
- * the previous generation cycle, enabling comparison and consistency checks.
- *
- * @author Juntak
+ * Request to retrieve analysis sections from the previous iteration by numeric
+ * ID.
  */
 export interface IAutoBePreliminaryGetPreviousAnalysisSections {
-  /**
-   * Type discriminator for the request.
-   *
-   * Value "getPreviousAnalysisSections" indicates this is a preliminary data
-   * request for analysis sections from the previous iteration.
-   */
+  /** Type discriminator. */
   type: "getPreviousAnalysisSections";
 
   /**
-   * List of section IDs to retrieve from the previous iteration.
-   *
-   * CRITICAL: DO NOT request the same section IDs that you have already
-   * requested in previous calls.
+   * Section IDs to retrieve from previous iteration. DO NOT request same IDs
+   * already requested in previous calls.
    */
   sectionIds: (number & tags.Type<"uint32">)[] & tags.MinItems<1>;
 }

package/src/orchestrate/common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas.ts

@@ -1,88 +1,19 @@
 import { tags } from "typia";
 
 /**
- * Request to retrieve database schemas from a previous version.
+ * Request to retrieve database schemas from the previous iteration.
  *
- * This type is used to load database schema definitions 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 the database schema based on
- * user change requests, agents need to reference the previously generated
- * database schemas to understand the existing database structure and what needs
- * to be modified.
- *
- * **Key Difference from `getDatabaseSchemas`:**
- *
- * - `getDatabaseSchemas`: Fetches schemas from the **current version** (the
- *   version being generated right now)
- * - `getPreviousDatabaseSchemas`: Fetches schemas from the **previous version**
- *   (the last successfully generated version)
- *
- * **Example Scenario:**
- *
- *     Initial generation:
- *     - DATABASE phase creates: users, posts, comments tables
- *     - Generation completes successfully
- *
- *     User: "Add email verification status to users"
- *
- *     Regeneration:
- *     - DATABASE phase starts regeneration
- *     - Calls getPreviousDatabaseSchemas(["users"])
- *       → Loads the previous version of users table schema
- *     - Creates new version with emailVerified field added
- *
- * **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 changes
- *
- * @author Samchon
+ * Loads database table definitions from the last successfully generated
+ * version, used as reference context during regeneration or modification
+ * cycles.
  */
 export interface IAutoBePreliminaryGetPreviousDatabaseSchemas {
-  /**
-   * Type discriminator for the request.
-   *
-   * Determines which action to perform: preliminary data retrieval or actual
-   * task execution. Value "getPreviousDatabaseSchemas" indicates this is a
-   * preliminary data request for database schemas from a previous version.
-   */
+  /** Type discriminator. */
   type: "getPreviousDatabaseSchemas";
 
   /**
-   * List of database table names to retrieve from the previous version.
-   *
-   * These are table schema names that were generated in a previous version and
-   * are needed as reference context for the current regeneration.
-   *
-   * **Important Notes:**
-   *
-   * - These schemas 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
-   * - Table names are in snake_case (e.g., "shopping_sale", "bbs_article")
-   *
-   * **When This Function is Available:**
-   *
-   * - When a previous version exists
-   * - When user requests modifications to existing database schema
-   * - During correction/regeneration cycles that need previous schema context
-   *
-   * **When This Function is NOT Available:**
-   *
-   * - During initial generation (no previous version exists)
-   * - No previous database schemas available for this orchestration task
-   *
-   * **Example Table Names:**
-   *
-   * - "users", "posts", "comments"
-   * - "shopping_sales", "shopping_orders", "shopping_products"
-   * - "bbs_articles", "bbs_article_files"
+   * Table names to retrieve from previous iteration. DO NOT request same names
+   * already requested in previous calls.
    */
   schemaNames: string[] & tags.MinItems<1>;
 }

package/src/orchestrate/common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations.ts

@@ -2,101 +2,18 @@ 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/src/orchestrate/common/structures/IAutoBePreliminaryGetPreviousInterfaceSchemas.ts

@@ -1,105 +1,19 @@
 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/src/orchestrate/common/structures/IAutoBePreliminaryGetRealizeCollectors.ts

@@ -1,31 +1,12 @@
 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>;