@autobe/agent 0.27.0 → 0.28.1

package/src/orchestrate/analyze/structures/IAutoBeAnalyzeReviewApplication.ts

@@ -1,24 +1,11 @@
 export interface IAutoBeAnalyzeReviewApplication {
   /**
-   * Enhances planning documentation to meet all quality standards and requirements.
+   * Enhances and finalizes planning documentation.
    *
-   * This function receives a document and outputs an improved version directly.
-   * The output IS the enhanced document itself, NOT review comments or feedback.
+   * Receives a draft document and outputs the improved version. The output is
+   * the enhanced document itself, not review comments.
    *
-   * The enhancement process includes:
-   * - Expanding sections that are too brief
-   * - Converting vague statements to specific EARS format requirements
-   * - Fixing Mermaid diagram syntax errors
-   * - Adding missing business processes and workflows
-   * - Ensuring proper document structure and completeness
-   *
-   * DO: Output the actual document content that will be saved.
-   * DO NOT: Output review comments or analysis of the document.
-   * 
-   * Note: Any text output becomes part of the final document.
-   *
-   * @param props - The properties containing the document to enhance along with
-   *   plan and review criteria for guidance
+   * @param props - Document content, plan, and review criteria
    */
   review(props: IAutoBeAnalyzeReviewApplication.IProps): void;
 }
@@ -27,7 +14,7 @@ export namespace IAutoBeAnalyzeReviewApplication {
   export interface IProps {
     /**
      * Step 1 (CoT: Review Phase) - Enhancement Criteria
-     * 
+     *
      * The enhancement criteria and guidelines that the agent must follow.
      *
      * This includes:
@@ -48,14 +35,16 @@ export namespace IAutoBeAnalyzeReviewApplication {
      * - DO NOT: Use spaces between brackets and quotes in Mermaid
      * - DO: Make requirements specific and measurable in natural language
      * - DO: Focus on business requirements and user scenarios
-     * - DO NOT: Accept documents containing database schemas or API specifications
-     * - DO: Describe business model and authentication requirements in natural language
+     * - DO NOT: Accept documents containing database schemas or API
+     *   specifications
+     * - DO: Describe business model and authentication requirements in natural
+     *   language
      */
     review: string;
 
     /**
      * Step 2 (CoT: Plan Phase) - Original Document Plan
-     * 
+     *
      * The document plan that was used to create the content.
      *
      * This helps the reviewer understand:
@@ -71,43 +60,19 @@ export namespace IAutoBeAnalyzeReviewApplication {
     plan: string;
 
     /**
-     * Step 3 (CoT: Content Phase) - Complete Document Content
-     * 
-     * The actual markdown document content that incorporates review feedback.
+     * Step 3 (CoT: Content Phase) - Document Content (INPUT → OUTPUT)
      *
-     * This field contains a COMPLETE MARKDOWN DOCUMENT that has already 
-     * incorporated the review criteria and plan requirements.
-     * 
-     * DO: Treat this as the final, production-ready document.
-     * DO NOT: Treat this as raw input to be reviewed.
-     * 
-     * This content represents:
-     * - A fully-formed markdown document (.md file)
-     * - The result of applying review criteria to the original plan
-     * - A production-ready document for immediate deployment
-     * - Complete business requirements ready for developers
-     * 
-     * The enhancer should treat this as the actual document content:
+     * INPUT: The document written by Write Agent (may have issues) OUTPUT: The
+     * enhanced, complete markdown document to be saved
      *
-     * - Length and completeness (minimum 2,000 characters, more for technical
-     *   docs)
-     * - All sections from the plan are fully written
-     * - No vague or abstract statements
-     * - Proper use of EARS format for requirements
-     * - Correct Mermaid diagram syntax (double quotes mandatory)
-     * - Appropriate level of detail for backend implementation
-     * - Proper document linking (descriptive text, not raw filenames)
+     * Enhancement requirements:
      *
-     * The enhancer outputs the document itself:
+     * - Fix Mermaid syntax errors (add quotes, fix arrows)
+     * - Convert vague statements to EARS format
+     * - Expand sections that are too brief
+     * - Add missing business processes
      *
-     * - If content is provided, it represents the actual document
-     * - The enhancer outputs the enhanced version AS the document itself
-     * - No meta-commentary or review feedback should be in the output
-     * - The output becomes the saved .md file directly
-     * 
-     * Example of what this field contains:
-     * "# Service Overview\n## Vision\nThe service provides..." (actual document)
-     * NOT: "This document should cover service overview..." (review comment)
+     * Output must be the actual document content (not review comments).
      */
     content: string;
   }

package/src/orchestrate/analyze/structures/IAutoBeAnalyzeScenarioApplication.ts

@@ -4,18 +4,12 @@ import { tags } from "typia";
 
 export interface IAutoBeAnalyzeScenarioApplication {
   /**
-   * Compose project structure with actors and files.
+   * Composes project structure with actors and documentation files.
    *
-   * Design a list of actors and initial documents that you need to create for
-   * that requirement. Actors define user types and their responsibilities, while files
-   * define the documentation structure. These are managed separately. If you
-   * determine from the conversation that the user's requirements have not been
-   * fully gathered, you must stop the analysis and continue collecting the
-   * remaining requirements. In this case, you do not need to generate any files
-   * or actors. Simply pass an empty array to `input.files` and `input.actors`.
+   * Determines the list of user actors and documents to generate based on
+   * requirements. If requirements are incomplete, returns empty arrays.
    *
-   * @param input Prefix, actors, and files
-   * @returns
+   * @param input - Project prefix, actors, and file list
    */
   compose(input: IAutoBeAnalyzeScenarioApplication.IProps): void;
 }
@@ -33,7 +27,15 @@ export namespace IAutoBeAnalyzeScenarioApplication {
      */
     prefix: string & CamelCasePattern;
 
-    /** Actors to be assigned for the project */
+    /**
+     * Actors to be assigned for the project.
+     *
+     * Each actor has:
+     *
+     * - `name`: Actor identifier (camelCase)
+     * - `kind`: "guest" | "member" | "admin"
+     * - `description`: Actor's permissions and capabilities
+     */
     actors: AutoBeAnalyzeActor[];
 
     /**
@@ -53,12 +55,14 @@ export namespace IAutoBeAnalyzeScenarioApplication {
     page: number;
 
     /**
-     * # Document files to be generated
-     *
-     * File name must be English and it must contain the numbering and prefix.
+     * Array of document metadata objects defining files to be generated.
      *
-     * These files represent business documentation that may include:
+     * Each array element is an AutoBeAnalyzeFile.Scenario object containing:
+     * - filename: The output file name (e.g., "01-service-overview.md")
+     * - reason: Why this document is being created
+     * - documentType, outline, constraints, etc.: Metadata guiding content generation
      *
+     * These documents represent business-focused planning documentation:
      * - Business requirements and functional specifications in natural language
      * - User journey mapping and use case scenarios
      * - Business rules and workflow definitions
@@ -68,17 +72,16 @@ export namespace IAutoBeAnalyzeScenarioApplication {
      * - DO NOT: Include database schemas, ERD, or API specifications
      * - DO: Write all requirements in natural language for clarity
      *
-     * Generate files based on actual requirements gathered from conversation.
+     * Generate metadata objects based on actual requirements gathered from conversation.
      * Do not create unnecessary documentation - only generate what is needed to
      * properly define the business requirements and system specifications.
      *
-     * # Page Length Rules
+     * # Array Length Rules
      *
-     * The number of documents must match the user's request, excluding the
-     * table of contents. For example, if the user requests 3 pages, a total of
-     * 4 documents should be generated, including the table of contents. If the
-     * user does not specify a number, generate a sufficient number of documents
-     * to adequately support the service.
+     * The array length must match the user's requested page count plus one for ToC.
+     * For example: user requests 3 pages → generate 4 objects (1 ToC + 3 content).
+     * If user does not specify a number, generate sufficient objects to adequately
+     * document the service (typically 11+ objects including ToC).
      */
     files: Array<AutoBeAnalyzeFile.Scenario> & tags.MinItems<1>;
   }

package/src/orchestrate/analyze/structures/IAutoBeAnalyzeWriteApplication.ts

@@ -16,7 +16,7 @@ export namespace IAutoBeAnalyzeWriteApplication {
   export interface IProps {
     /**
      * Step 1 (CoT: Plan Phase) - Document Planning Structure
-     * 
+     *
      * The document planning structure that outlines what needs to be written.
      *
      * This includes:
@@ -42,33 +42,17 @@ export namespace IAutoBeAnalyzeWriteApplication {
     plan: string;
 
     /**
-     * Step 2 (CoT: Write Phase) - Document Content Creation
-     * 
-     * The initial content or context for the document being written.
-     *
-     * This may include:
-     *
-     * - User requirements and business goals
-     * - Existing documentation to build upon
-     * - Specific scenarios or use cases to document
-     * - Technical constraints or preferences
-     * - Related documents for reference
+     * Step 2 (CoT: Write Phase) - Complete Document Content
      *
-     * The content provides the raw material that the AI agent will transform
-     * into structured, developer-ready documentation following the planning
-     * guidelines.
+     * The complete, production-ready markdown document content to be saved.
      *
-     * The AI agent will expand this content into comprehensive documentation
-     * that:
+     * Requirements:
      *
-     * - Removes all ambiguity for backend developers
-     * - Provides specific, measurable requirements in natural language
-     * - Focuses on business logic and requirements, NOT technical implementation
-     * - STRICTLY PROHIBITED: Do NOT write database schemas, ERD, or API
-     *   specifications
+     * - Minimum 5,000 characters for technical documents
      * - Uses EARS format for all applicable requirements
-     * - Follows proper document linking conventions
-     * - Includes Mermaid diagrams with proper syntax (double quotes mandatory)
+     * - Includes proper Mermaid diagram syntax (double quotes for labels)
+     * - Focuses on business requirements in natural language
+     * - PROHIBITED: Database schemas, ERD, API specifications
      */
     content: string;
   }

package/src/orchestrate/common/orchestrateCommonCorrectCasting.ts

@@ -170,7 +170,11 @@ const createController = <Model extends ILlmSchema.Model>(props: {
       : result;
   };
   const application = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](validate) satisfies ILlmApplication<any> as any as ILlmApplication<Model>;
   return {
     protocol: "class",
@@ -208,6 +212,16 @@ const collection = {
         }),
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<IAutoBeCommonCorrectCastingApplication, "gemini">({
+      validate: {
+        rewrite: validate,
+        reject: () => ({
+          success: true,
+          data: undefined,
+        }),
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/facade/createAutoBeFacadeController.ts

@@ -29,7 +29,11 @@ export const createAutoBeFacadeController = <
 }): IAgenticaController.IClass<Model> => {
   assertSchemaModel(props.model);
   const application: ILlmApplication<Model> = collection[
-    props.model
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
@@ -125,11 +129,8 @@ export const createAutoBeFacadeController = <
   };
 };
 
-const claude = typia.llm.application<IAutoBeFacadeApplication, "claude">();
 const collection = {
   chatgpt: typia.llm.application<IAutoBeFacadeApplication, "chatgpt">(),
-  claude,
-  llama: claude,
-  deepseek: claude,
-  "3.1": claude,
+  claude: typia.llm.application<IAutoBeFacadeApplication, "claude">(),
+  gemini: typia.llm.application<IAutoBeFacadeApplication, "gemini">(),
 };

package/src/orchestrate/interface/orchestrateInterfaceAuthorizations.ts

@@ -196,7 +196,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -228,6 +232,12 @@ const collection = {
         makeOperations: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfaceAuthorizationsApplication, "gemini">({
+      validate: {
+        makeOperations: validate,
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/interface/orchestrateInterfaceComplement.ts

@@ -156,7 +156,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -185,6 +189,12 @@ const collection = {
         complementComponents: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfaceComplementApplication, "gemini">({
+      validate: {
+        complementComponents: validate,
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/interface/orchestrateInterfaceEndpoints.ts

@@ -118,7 +118,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   assertSchemaModel(props.model);
 
   const application: ILlmApplication<Model> = collection[
-    props.model
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
@@ -132,17 +136,17 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 }
 
-const claude = typia.llm.application<
-  IAutoBeInterfaceEndpointApplication,
-  "claude"
->();
 const collection = {
   chatgpt: typia.llm.application<
     IAutoBeInterfaceEndpointApplication,
     "chatgpt"
   >(),
-  claude,
-  llama: claude,
-  deepseek: claude,
-  "3.1": claude,
+  claude: typia.llm.application<
+    IAutoBeInterfaceEndpointApplication,
+    "claude"
+  >(),
+  gemini: typia.llm.application<
+    IAutoBeInterfaceEndpointApplication,
+    "gemini"
+  >(),
 };

package/src/orchestrate/interface/orchestrateInterfaceEndpointsReview.ts

@@ -64,7 +64,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   assertSchemaModel(props.model);
 
   const application: ILlmApplication<Model> = collection[
-    props.model
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
@@ -78,17 +82,17 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 }
 
-const claude = typia.llm.application<
-  IAutoBeInterfaceEndpointsReviewApplication,
-  "claude"
->();
 const collection = {
   chatgpt: typia.llm.application<
     IAutoBeInterfaceEndpointsReviewApplication,
     "chatgpt"
   >(),
-  claude,
-  llama: claude,
-  deepseek: claude,
-  "3.1": claude,
+  claude: typia.llm.application<
+    IAutoBeInterfaceEndpointsReviewApplication,
+    "claude"
+  >(),
+  gemini: typia.llm.application<
+    IAutoBeInterfaceEndpointsReviewApplication,
+    "gemini"
+  >(),
 };

package/src/orchestrate/interface/orchestrateInterfaceGroups.ts

@@ -57,7 +57,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   assertSchemaModel(props.model);
 
   const application: ILlmApplication<Model> = collection[
-    props.model
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
@@ -71,18 +75,17 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 }
 
-const claude = typia.llm.application<
-  IAutoBeInterfaceGroupApplication,
-  "claude"
->();
-const chatgpt = typia.llm.application<
-  IAutoBeInterfaceGroupApplication,
-  "chatgpt"
->();
 const collection = {
-  chatgpt,
-  claude,
-  llama: claude,
-  deepseek: claude,
-  "3.1": claude,
+  chatgpt: typia.llm.application<
+    IAutoBeInterfaceGroupApplication,
+    "chatgpt"
+  >(),
+  claude: typia.llm.application<
+    IAutoBeInterfaceGroupApplication,
+    "claude"
+  >(),
+  gemini: typia.llm.application<
+    IAutoBeInterfaceGroupApplication,
+    "gemini"
+  >(),
 };

package/src/orchestrate/interface/orchestrateInterfaceOperations.ts

@@ -244,7 +244,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
     return result;
   };
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -274,6 +278,12 @@ const collection = {
         makeOperations: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfaceOperationApplication, "gemini">({
+      validate: {
+        makeOperations: validate,
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/interface/orchestrateInterfaceOperationsReview.ts

@@ -101,7 +101,11 @@ function createReviewController<Model extends ILlmSchema.Model>(props: {
     return result;
   };
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -137,6 +141,15 @@ const collection = {
         reviewOperations: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<
+      IAutoBeInterfaceOperationsReviewApplication,
+      "gemini"
+    >({
+      validate: {
+        reviewOperations: validate,
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/interface/orchestrateInterfacePrerequisites.ts

@@ -238,7 +238,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -268,6 +272,12 @@ const collection = {
         makePrerequisite: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfacePrerequisitesApplication, "gemini">({
+      validate: {
+        makePrerequisite: validate,
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/interface/orchestrateInterfaceSchemaRename.ts

@@ -244,7 +244,11 @@ const createController = <Model extends ILlmSchema.Model>(
 ): IAgenticaController.IClass<Model> => {
   assertSchemaModel(model);
   const application: ILlmApplication<Model> = collection[
-    model === "chatgpt" ? "chatgpt" : "claude"
+    model === "chatgpt"
+      ? "chatgpt"
+      : model === "gemini"
+        ? "gemini"
+        : "claude"
   ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
@@ -267,4 +271,8 @@ const collection = {
     IAutoBeInterfaceSchemaRenameApplication,
     "claude"
   >(),
+  gemini: typia.llm.application<
+    IAutoBeInterfaceSchemaRenameApplication,
+    "gemini"
+  >(),
 };

package/src/orchestrate/interface/orchestrateInterfaceSchemaReview.ts

@@ -177,7 +177,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -212,6 +216,15 @@ const collection = {
         review: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<
+      IAutoBeInterfaceSchemaContentReviewApplication,
+      "gemini"
+    >({
+      validate: {
+        review: validate,
+      },
+    }),
 };
 
 type Validator = (

package/src/orchestrate/interface/orchestrateInterfaceSchemas.ts

@@ -240,7 +240,11 @@ function createController<Model extends ILlmSchema.Model>(props: {
   };
 
   const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt" ? "chatgpt" : "claude"
+    props.model === "chatgpt"
+      ? "chatgpt"
+      : props.model === "gemini"
+        ? "gemini"
+        : "claude"
   ](
     validate,
   ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
@@ -269,6 +273,12 @@ const collection = {
         makeComponents: validate,
       },
     }),
+  gemini: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfaceSchemaApplication, "gemini">({
+      validate: {
+        makeComponents: validate,
+      },
+    }),
 };
 
 type Validator = (