@autobe/agent 0.30.0-dev.20260315 → 0.30.0

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

@@ -1,105 +1,105 @@
-import { tags } from "typia";
-
-/**
- * Request to retrieve interface schemas from a previous version.
- *
- * 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
- */
-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: "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"
-   */
-  typeNames: string[] & tags.MinItems<1>;
-}
+import { tags } from "typia";
+
+/**
+ * Request to retrieve interface schemas from a previous version.
+ *
+ * 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
+ */
+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: "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"
+   */
+  typeNames: string[] & tags.MinItems<1>;
+}

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

@@ -1,32 +1,32 @@
-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
- */
-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: "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
-   * requested in previous calls.
-   */
-  dtoTypeNames: string[] & tags.MinItems<1>;
-}
+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
+ */
+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: "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
+   * requested in previous calls.
+   */
+  dtoTypeNames: string[] & tags.MinItems<1>;
+}

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

@@ -1,32 +1,32 @@
-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
- */
-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: "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
-   * requested in previous calls.
-   */
-  dtoTypeNames: string[] & tags.MinItems<1>;
-}
+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
+ */
+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: "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
+   * requested in previous calls.
+   */
+  dtoTypeNames: string[] & tags.MinItems<1>;
+}

package/src/orchestrate/facade/createAutoBeFacadeController.ts

@@ -1,118 +1,118 @@
-import {
-  AutoBeAnalyzeHistory,
-  AutoBeAssistantMessageEvent,
-  AutoBeAssistantMessageHistory,
-  AutoBeDatabaseHistory,
-  AutoBeInterfaceHistory,
-  AutoBeRealizeHistory,
-  AutoBeTestHistory,
-} from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import typia, { ILlmApplication, ILlmController } from "typia";
-
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { orchestrateAnalyze } from "../analyze/orchestrateAnalyze";
-import { orchestrateInterface } from "../interface/orchestrateInterface";
-import { orchestratePrisma } from "../prisma/orchestratePrisma";
-import { orchestrateRealize } from "../realize/orchestrateRealize";
-import { orchestrateTest } from "../test/orchestrateTest";
-import { IAutoBeFacadeApplication } from "./histories/IAutoBeFacadeApplication";
-
-export const createAutoBeFacadeController = (props: {
-  context: AutoBeContext;
-}): ILlmController<IAutoBeFacadeApplication> => {
-  const application: ILlmApplication =
-    typia.llm.application<IAutoBeFacadeApplication>();
-  return {
-    protocol: "class",
-    name: "autobe",
-    application,
-    execute: {
-      analyze: async () => {
-        const history: AutoBeAssistantMessageHistory | AutoBeAnalyzeHistory =
-          await orchestrateAnalyze(props.context);
-        if (history.type === "assistantMessage")
-          return {
-            type: "in-progress",
-            description: StringUtil.trim`
-              Requirements are not yet fully elicited,
-              therefore additional questions will be made to the user.
-            `,
-          };
-        return {
-          type: "success",
-          description:
-            "Analysis completed successfully, and report has been published.",
-        };
-      },
-      database: async (next) => {
-        const history: AutoBeAssistantMessageHistory | AutoBeDatabaseHistory =
-          await orchestratePrisma(props.context, next);
-        if (history.type === "assistantMessage")
-          return {
-            type: "prerequisites-not-satisfied",
-            description: "Requirement analysis is not yet completed.",
-          };
-        return {
-          type: history.compiled.type,
-          description:
-            history.compiled.type === "success"
-              ? "Database schemas have been generated successfully."
-              : history.result.success === false ||
-                  history.compiled.type === "failure"
-                ? "Database schemas are generated, but compilation failed."
-                : "Unexpected error occurred while generating database schemas.",
-        };
-      },
-      interface: async (next) => {
-        const history: AutoBeAssistantMessageEvent | AutoBeInterfaceHistory =
-          await orchestrateInterface(props.context)(next);
-        if (history.type === "assistantMessage")
-          return {
-            type: "prerequisites-not-satisfied",
-            description: "Database schemas are not yet completed.",
-          };
-        return {
-          type: "success",
-          description: "API interfaces have been designed successfully.",
-        };
-      },
-      test: async (next) => {
-        const history: AutoBeAssistantMessageHistory | AutoBeTestHistory =
-          await orchestrateTest(props.context)(next);
-        if (history.type === "assistantMessage")
-          return {
-            type: "prerequisites-not-satisfied",
-            description: "API interfaces are not yet completed.",
-          };
-        return {
-          type: history.compiled.type,
-          description:
-            history.compiled.type === "success"
-              ? "Test functions have been generated successfully."
-              : history.compiled.type === "failure"
-                ? "Test functions are written, but compilation failed."
-                : "Unexpected error occurred while writing test functions.",
-        };
-      },
-      realize: async (next) => {
-        const history: AutoBeAssistantMessageHistory | AutoBeRealizeHistory =
-          await orchestrateRealize(props.context)(next);
-        if (history.type === "assistantMessage")
-          return {
-            type: "prerequisites-not-satisfied",
-            description: "API interfaces are not yet completed.",
-          };
-        return {
-          type: history.compiled.type,
-          description:
-            history.compiled.type === "success"
-              ? "API implementation codes have been generated successfully."
-              : history.compiled.type === "failure"
-                ? "Implementation codes are composed, but compilation failed."
-                : "Unexpected error occurred while writing implementation codes.",
-        };
-      },
-    } satisfies IAutoBeFacadeApplication,
-  };
-};
+import {
+  AutoBeAnalyzeHistory,
+  AutoBeAssistantMessageEvent,
+  AutoBeAssistantMessageHistory,
+  AutoBeDatabaseHistory,
+  AutoBeInterfaceHistory,
+  AutoBeRealizeHistory,
+  AutoBeTestHistory,
+} from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import typia, { ILlmApplication, ILlmController } from "typia";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { orchestrateAnalyze } from "../analyze/orchestrateAnalyze";
+import { orchestrateInterface } from "../interface/orchestrateInterface";
+import { orchestratePrisma } from "../prisma/orchestratePrisma";
+import { orchestrateRealize } from "../realize/orchestrateRealize";
+import { orchestrateTest } from "../test/orchestrateTest";
+import { IAutoBeFacadeApplication } from "./histories/IAutoBeFacadeApplication";
+
+export const createAutoBeFacadeController = (props: {
+  context: AutoBeContext;
+}): ILlmController<IAutoBeFacadeApplication> => {
+  const application: ILlmApplication =
+    typia.llm.application<IAutoBeFacadeApplication>();
+  return {
+    protocol: "class",
+    name: "autobe",
+    application,
+    execute: {
+      analyze: async () => {
+        const history: AutoBeAssistantMessageHistory | AutoBeAnalyzeHistory =
+          await orchestrateAnalyze(props.context);
+        if (history.type === "assistantMessage")
+          return {
+            type: "in-progress",
+            description: StringUtil.trim`
+              Requirements are not yet fully elicited,
+              therefore additional questions will be made to the user.
+            `,
+          };
+        return {
+          type: "success",
+          description:
+            "Analysis completed successfully, and report has been published.",
+        };
+      },
+      database: async (next) => {
+        const history: AutoBeAssistantMessageHistory | AutoBeDatabaseHistory =
+          await orchestratePrisma(props.context, next);
+        if (history.type === "assistantMessage")
+          return {
+            type: "prerequisites-not-satisfied",
+            description: "Requirement analysis is not yet completed.",
+          };
+        return {
+          type: history.compiled.type,
+          description:
+            history.compiled.type === "success"
+              ? "Database schemas have been generated successfully."
+              : history.result.success === false ||
+                  history.compiled.type === "failure"
+                ? "Database schemas are generated, but compilation failed."
+                : "Unexpected error occurred while generating database schemas.",
+        };
+      },
+      interface: async (next) => {
+        const history: AutoBeAssistantMessageEvent | AutoBeInterfaceHistory =
+          await orchestrateInterface(props.context)(next);
+        if (history.type === "assistantMessage")
+          return {
+            type: "prerequisites-not-satisfied",
+            description: "Database schemas are not yet completed.",
+          };
+        return {
+          type: "success",
+          description: "API interfaces have been designed successfully.",
+        };
+      },
+      test: async (next) => {
+        const history: AutoBeAssistantMessageHistory | AutoBeTestHistory =
+          await orchestrateTest(props.context)(next);
+        if (history.type === "assistantMessage")
+          return {
+            type: "prerequisites-not-satisfied",
+            description: "API interfaces are not yet completed.",
+          };
+        return {
+          type: history.compiled.type,
+          description:
+            history.compiled.type === "success"
+              ? "Test functions have been generated successfully."
+              : history.compiled.type === "failure"
+                ? "Test functions are written, but compilation failed."
+                : "Unexpected error occurred while writing test functions.",
+        };
+      },
+      realize: async (next) => {
+        const history: AutoBeAssistantMessageHistory | AutoBeRealizeHistory =
+          await orchestrateRealize(props.context)(next);
+        if (history.type === "assistantMessage")
+          return {
+            type: "prerequisites-not-satisfied",
+            description: "API interfaces are not yet completed.",
+          };
+        return {
+          type: history.compiled.type,
+          description:
+            history.compiled.type === "success"
+              ? "API implementation codes have been generated successfully."
+              : history.compiled.type === "failure"
+                ? "Implementation codes are composed, but compilation failed."
+                : "Unexpected error occurred while writing implementation codes.",
+        };
+      },
+    } satisfies IAutoBeFacadeApplication,
+  };
+};