@autobe/agent 0.20.0 → 0.21.0

package/lib/orchestrate/interface/histories/transformInterfaceEndpointsReviewHistories.d.ts

@@ -0,0 +1,4 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+import { AutoBeOpenApi } from "@autobe/interface";
+import { AutoBeState } from "../../../context/AutoBeState";
+export declare const transformInterfaceEndpointsReviewHistories: (state: AutoBeState, endpoints: AutoBeOpenApi.IEndpoint[]) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;

package/lib/orchestrate/interface/orchestrateInterfaceEndpointsReview.d.ts

@@ -0,0 +1,10 @@
+import { IAgenticaController } from "@agentica/core";
+import { AutoBeOpenApi } from "@autobe/interface";
+import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { IAutoBeInterfaceEndpointsReviewApplication } from "./structures/IAutoBeInterfaceEndpointsReviewApplication";
+export declare function orchestrateInterfaceEndpointsReview<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, endpoints: AutoBeOpenApi.IEndpoint[], message?: string): Promise<AutoBeOpenApi.IEndpoint[]>;
+export declare function createController<Model extends ILlmSchema.Model>(props: {
+    model: Model;
+    build: (props: IAutoBeInterfaceEndpointsReviewApplication.IProps) => void;
+}): IAgenticaController.IClass<Model>;

package/lib/orchestrate/interface/structures/IAutoBeInterfaceEndpointsReviewApplication.d.ts

@@ -0,0 +1,60 @@
+import { AutoBeOpenApi } from "@autobe/interface";
+/**
+ * Interface for reviewing and refining API endpoints through holistic analysis.
+ *
+ * This application performs comprehensive review of all endpoints generated
+ * through divide-and-conquer strategy, ensuring consistency, eliminating
+ * redundancy, and preventing over-engineering across the entire API surface.
+ */
+export interface IAutoBeInterfaceEndpointsReviewApplication {
+    /**
+     * Reviews and refines the complete collection of API endpoints.
+     *
+     * This method consolidates all endpoints generated independently by different
+     * groups and performs holistic review to:
+     * - Ensure naming consistency across all endpoints
+     * - Remove duplicate or overlapping endpoints
+     * - Eliminate over-engineered solutions
+     * - Standardize path structures and HTTP methods
+     * - Verify REST API design principles
+     *
+     * The review process examines the entire API as a cohesive system rather
+     * than individual endpoints, ensuring the final API is intuitive, maintainable,
+     * and follows best practices.
+     *
+     * @param next - The review results and refined endpoint collection
+     */
+    reviewEndpoints(next: IAutoBeInterfaceEndpointsReviewApplication.IProps): void;
+}
+export declare namespace IAutoBeInterfaceEndpointsReviewApplication {
+    interface IProps {
+        /**
+         * Comprehensive review analysis of all collected endpoints.
+         *
+         * Contains detailed findings from the holistic review including:
+         * - Identified inconsistencies in naming conventions
+         * - Duplicate endpoints that serve the same purpose
+         * - Over-engineered solutions that add unnecessary complexity
+         * - Violations of REST API design principles
+         * - Recommendations for improvement and standardization
+         *
+         * The review provides actionable feedback for creating a clean,
+         * consistent, and maintainable API structure.
+         */
+        review: string;
+        /**
+         * Refined collection of API endpoints after review and cleanup.
+         *
+         * The final optimized set of endpoints after:
+         * - Removing duplicates and redundant endpoints
+         * - Standardizing naming conventions across all paths
+         * - Simplifying over-engineered solutions
+         * - Ensuring consistent REST patterns
+         * - Aligning HTTP methods with their semantic meanings
+         *
+         * This collection represents the production-ready API structure
+         * that balances functionality with simplicity and maintainability.
+         */
+        endpoints: AutoBeOpenApi.IEndpoint[];
+    }
+}

package/lib/orchestrate/interface/structures/IAutoBeInterfaceOperationsReviewApplication.d.ts

@@ -166,5 +166,45 @@ export declare namespace IAutoBeInterfaceOperationsReviewApplication {
          * database structure and business logic requirements.
          */
         prisma_schemas: string;
+        /**
+         * Primary Prisma model name for this operation.
+         *
+         * Identifies the main database table/model that this operation targets.
+         * This must match exactly with the Prisma model name defined in the schema.
+         * When soft deletion is specified, this model name indicates which table
+         * should be soft-deleted.
+         *
+         * For example:
+         * - In a "GET /users/:id" operation, this would be "User"
+         * - In a "POST /articles" operation, this would be "Article"
+         * - In a "DELETE /comments/:id" with soft delete, this specifies the "Comment" model to soft-delete
+         *
+         * This property is essential for:
+         * - Determining the primary entity for CRUD operations
+         * - Identifying which table to apply soft deletion to
+         * - Validating operations against the correct Prisma model
+         * - Generating appropriate database queries and validations
+         */
+        model_name: string;
+        /**
+         * Soft delete column name for the Prisma models.
+         *
+         * Specifies the column name used for soft deletion in the database tables
+         * associated with this operation. When set to a non-null value, it indicates
+         * that the related entities support soft deletion through this column
+         * (typically a timestamp field like `deleted_at` or `deletedAt`).
+         *
+         * When null, it means the entities involved in this operation use hard
+         * deletion or don't support deletion at all. This information is crucial
+         * for generating appropriate CRUD operations and ensuring data integrity
+         * policies are correctly implemented.
+         *
+         * Common soft delete patterns:
+         * - `"deleted_at"`: Records deletion timestamp
+         * - `"deletedAt"`: Camel-cased deletion timestamp
+         * - `"is_deleted"`: Boolean flag for deletion status
+         * - `null`: No soft deletion (hard delete only)
+         */
+        soft_delete_column: string | null;
     }
 }

package/lib/orchestrate/realize/structures/IAutoBeRealizeScenarioApplication.d.ts

@@ -1,4 +1,4 @@
-import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
+import { AutoBeOpenApi, AutoBeRealizeAuthorization, AutoBeTestFile } from "@autobe/interface";
 export declare namespace IAutoBeRealizeScenarioApplication {
     interface IProps {
         /** The OpenAPI operation to be realized. */
@@ -24,7 +24,7 @@ export declare namespace IAutoBeRealizeScenarioApplication {
          * certain conditions. Used as a basis for TDD-style automated test
          * generation.
          */
-        testScenarios: string[];
+        testFiles: AutoBeTestFile[];
         /**
          * Optional decorator event for customizing code generation behavior.
          *

package/lib/orchestrate/realize/structures/IAutoBeRealizeWriteApplication.d.ts

@@ -17,13 +17,16 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * 📋 STEP 1 - PRISMA SCHEMA VERIFICATION:
          *
          * DO:
+         *
          * - Examine the actual Prisma schema model definition
          * - List EVERY field that exists in the model with exact types
          * - Explicitly note fields that DO NOT exist
          *
          * DO NOT:
+         *
          * - Assume common fields exist without verification
-         * - Use fields like deleted_at, created_by, updated_by, is_deleted, is_active without checking
+         * - Use fields like deleted_at, created_by, updated_by, is_deleted, is_active
+         *   without checking
          *
          * 📋 STEP 2 - FIELD INVENTORY:
          *
@@ -171,10 +174,12 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * Import rules:
          *
          * DO NOT:
+         *
          * - Add any new import statements manually
          * - Write import statements directly (this causes compile errors)
          *
-         * Note: All necessary imports are provided globally or by the system automatically.
+         * Note: All necessary imports are provided globally or by the system
+         * automatically.
          *
          * ✅ Requirements:
          *

package/lib/orchestrate/test/histories/transformTestCorrectHistories.d.ts

@@ -1,4 +1,6 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeContext } from "../../../context/AutoBeContext";
 import { IAutoBeTestFunction } from "../structures/IAutoBeTestFunction";
-export declare const transformTestCorrectHistories: (func: IAutoBeTestFunction, failure: IAutoBeTypeScriptCompileResult.IFailure) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;
+export declare const transformTestCorrectHistories: <Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, func: IAutoBeTestFunction, failure: IAutoBeTypeScriptCompileResult.IFailure) => Promise<Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>>;

package/lib/orchestrate/test/histories/transformTestWriteHistories.d.ts

@@ -1,7 +1,9 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeTestScenario } from "@autobe/interface";
+import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeContext } from "../../../context/AutoBeContext";
 import { IAutoBeTestScenarioArtifacts } from "../structures/IAutoBeTestScenarioArtifacts";
-export declare function transformTestWriteHistories(scenario: AutoBeTestScenario, artifacts: IAutoBeTestScenarioArtifacts): Array<IAgenticaHistoryJson.ISystemMessage>;
+export declare function transformTestWriteHistories<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, scenario: AutoBeTestScenario, artifacts: IAutoBeTestScenarioArtifacts): Promise<Array<IAgenticaHistoryJson.ISystemMessage | IAgenticaHistoryJson.IAssistantMessage>>;
 export declare namespace transformTestWriteHistories {
     function structures(artifacts: IAutoBeTestScenarioArtifacts): string;
     function functional(artifacts: IAutoBeTestScenarioArtifacts): string;

package/lib/orchestrate/test/structures/IAutoBeTestScenarioApplication.d.ts

@@ -28,6 +28,18 @@ export declare namespace IAutoBeTestScenarioApplication {
          *
          * Each scenario represents a specific test case for the same `path` and
          * `method`.
+         *
+         * IMPORTANT: Each scenario must be actually implementable. A scenario's
+         * implementability is determined by the existence of ALL APIs (endpoints)
+         * required to test it. This includes not only the primary endpoint being
+         * tested, but also ALL dependency endpoints needed for setup,
+         * authentication, and data preparation. If even one required dependency API
+         * is missing from the available operations, the scenario cannot be
+         * implemented and should not be generated.
+         *
+         * Example: A "test banned user login" scenario requires both a login API
+         * AND a ban user API. If the ban API doesn't exist, this scenario is not
+         * implementable regardless of database schema fields.
          */
         scenarios: IScenario[] & tags.MinItems<1>;
     }
@@ -37,6 +49,11 @@ export declare namespace IAutoBeTestScenarioApplication {
      * This interface defines a structured, user-centric test draft that includes
      * a descriptive function name, a detailed scenario draft, and logical
      * dependencies on other endpoints required for context or setup.
+     *
+     * CRITICAL: All referenced endpoints MUST exist in the provided API
+     * operations. Do NOT create scenarios for non-existent APIs, even if database
+     * schema fields suggest their existence. Test scenarios must be implementable
+     * with available APIs only.
      */
     interface IScenario {
         /**
@@ -113,11 +130,21 @@ export declare namespace IAutoBeTestScenarioApplication {
          * authentication, resource creation, or data setup, that are relevant to
          * the test. This list is not a strict execution order — if ordering is
          * important, it must be described explicitly in the `purpose`.
+         *
+         * WARNING: Every endpoint referenced here MUST exist in the provided API
+         * operations. Do NOT reference endpoints that are not explicitly available,
+         * even if they seem logically necessary based on database schema or
+         * business logic.
          */
         dependencies: IDependencies[];
     }
     interface IDependencies {
-        /** Target API endpoint that this scenario depends on. */
+        /**
+         * Target API endpoint that this scenario depends on.
+         *
+         * This endpoint MUST exist in the available API operations list.
+         * Non-existent endpoints will cause test implementation failures.
+         */
         endpoint: AutoBeOpenApi.IEndpoint;
         /**
          * A concise explanation of why this API call is relevant or required for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobe/agent",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "AI backend server code generator",
   "main": "lib/index.js",
   "author": "Wrtn Technologies",
@@ -25,10 +25,10 @@
     "@samchon/openapi": "^4.7.1",
     "openai": "^5.12.2",
     "tstl": "^3.0.0",
-    "typia": "^9.7.1",
+    "typia": "^9.7.2",
     "uuid": "^11.1.0",
-    "@autobe/interface": "^0.20.0",
-    "@autobe/utils": "^0.20.0"
+    "@autobe/utils": "^0.21.0",
+    "@autobe/interface": "^0.21.0"
   },
   "devDependencies": {
     "@rollup/plugin-json": "^6.1.0",
@@ -40,8 +40,8 @@
     "ts-node": "^10.9.2",
     "ts-patch": "^3.3.0",
     "typescript": "~5.9.2",
-    "@autobe/compiler": "^0.20.0",
-    "@autobe/filesystem": "^0.20.0"
+    "@autobe/filesystem": "^0.21.0",
+    "@autobe/compiler": "^0.21.0"
   },
   "keywords": [
     "ai",

package/src/AutoBeMockAgent.ts

@@ -175,6 +175,7 @@ const sleepMap: Record<AutoBeEvent.Type, number> = {
   interfaceStart: 1_000,
   interfaceGroups: 1_000,
   interfaceEndpoints: 1_000,
+  interfaceEndpointsReview: 1_000,
   interfaceOperations: 400,
   interfaceOperationsReview: 400,
   interfaceAuthorization: 400,