@autobe/agent 0.18.0 → 0.20.0

package/src/orchestrate/analyze/orchestrateAnalyze.ts

@@ -4,13 +4,15 @@ import {
   AutoBeAnalyzeScenarioEvent,
   AutoBeAnalyzeWriteEvent,
   AutoBeAssistantMessageHistory,
+  AutoBeProgressEventBase,
 } from "@autobe/interface";
 import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
 import { ILlmSchema } from "@samchon/openapi";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeApplicationProps } from "../../context/IAutoBeApplicationProps";
-import { IProgress } from "../internal/IProgress";
+import { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { orchestrateAnalyzeReview } from "./orchestrateAnalyzeReview";
 import { orchestrateAnalyzeScenario } from "./orchestrateAnalyzeScenario";
 import { orchestrateAnalyzeWrite } from "./orchestrateAnalyzeWrite";
@@ -26,6 +28,7 @@ export const orchestrateAnalyze =
 
     ctx.dispatch({
       type: "analyzeStart",
+      id: v7(),
       reason: props.reason,
       step,
       created_at: startTime.toISOString(),
@@ -39,46 +42,55 @@ export const orchestrateAnalyze =
     else ctx.dispatch(scenario);
 
     // write documents
-    const writeProgress: IProgress = {
+    const writeProgress: AutoBeProgressEventBase = {
       total: scenario.files.length,
       completed: 0,
     };
-    const fileList: AutoBeAnalyzeFile[] = await Promise.all(
-      scenario.files.map(async (file) => {
+    const fileList: AutoBeAnalyzeFile[] = await executeCachedBatch(
+      scenario.files.map((file) => async (promptCacheKey) => {
         const event: AutoBeAnalyzeWriteEvent = await orchestrateAnalyzeWrite(
           ctx,
-          scenario,
-          file,
-          writeProgress,
+          {
+            scenario,
+            file,
+            progress: writeProgress,
+            promptCacheKey,
+          },
         );
         return event.file;
       }),
     );
 
     // review documents
-    const reviewProgress: IProgress = {
+    const reviewProgress: AutoBeProgressEventBase = {
       total: fileList.length,
       completed: 0,
     };
-    const newFiles: AutoBeAnalyzeFile[] = await Promise.all(
-      fileList.map(async (file, i) => {
-        const event: AutoBeAnalyzeReviewEvent = await orchestrateAnalyzeReview(
-          ctx,
-          scenario,
-          fileList.filter((_, j) => j !== i), // other files
-          file,
-          reviewProgress,
-        );
-        return {
-          ...event.file,
-          content: event.content,
-        };
+    const newFiles: AutoBeAnalyzeFile[] = await executeCachedBatch(
+      fileList.map((file) => async (promptCacheKey) => {
+        try {
+          const event: AutoBeAnalyzeReviewEvent =
+            await orchestrateAnalyzeReview(ctx, {
+              scenario,
+              allFiles: fileList, // all files
+              myFile: file,
+              progress: reviewProgress,
+              promptCacheKey,
+            });
+          return {
+            ...event.file,
+            content: event.content,
+          };
+        } catch {
+          return file;
+        }
       }),
     );
 
     // Complete the analysis
     return ctx.dispatch({
       type: "analyzeComplete",
+      id: v7(),
       roles: scenario.roles,
       prefix: scenario.prefix,
       files: newFiles,

package/src/orchestrate/analyze/orchestrateAnalyzeReview.ts

@@ -2,24 +2,28 @@ import { IAgenticaController } from "@agentica/core";
 import {
   AutoBeAnalyzeReviewEvent,
   AutoBeAnalyzeScenarioEvent,
+  AutoBeProgressEventBase,
 } from "@autobe/interface";
 import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
-import { IProgress } from "../internal/IProgress";
-import { transformAnalyzeReviewerHistories } from "./histories/transformAnalyzeReviewerHistories";
+import { transformAnalyzeReviewHistories } from "./histories/transformAnalyzeReviewHistories";
 import { IAutoBeAnalyzeReviewApplication } from "./structures/IAutoBeAnalyzeReviewApplication";
 
 export const orchestrateAnalyzeReview = async <Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
-  scenario: AutoBeAnalyzeScenarioEvent,
-  otherFiles: AutoBeAnalyzeFile[],
-  myFile: AutoBeAnalyzeFile,
-  progress: IProgress,
+  props: {
+    scenario: AutoBeAnalyzeScenarioEvent;
+    allFiles: AutoBeAnalyzeFile[];
+    myFile: AutoBeAnalyzeFile;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
+  },
 ): Promise<AutoBeAnalyzeReviewEvent> => {
   const pointer: IPointer<IAutoBeAnalyzeReviewApplication.IProps | null> = {
     value: null,
@@ -31,9 +35,15 @@ export const orchestrateAnalyzeReview = async <Model extends ILlmSchema.Model>(
       pointer,
     }),
     histories: [
-      ...transformAnalyzeReviewerHistories(scenario, otherFiles, myFile),
+      ...transformAnalyzeReviewHistories(
+        ctx,
+        props.scenario,
+        props.allFiles,
+        props.myFile,
+      ),
     ],
     enforceFunctionCall: true,
+    promptCacheKey: props.promptCacheKey,
     message: "Review the requirement document",
   });
   if (pointer.value === null)
@@ -41,13 +51,14 @@ export const orchestrateAnalyzeReview = async <Model extends ILlmSchema.Model>(
 
   const event: AutoBeAnalyzeReviewEvent = {
     type: "analyzeReview",
-    file: myFile,
+    id: v7(),
+    file: props.myFile,
     plan: pointer.value.plan,
     review: pointer.value.review,
     content: pointer.value.content,
     tokenUsage,
-    total: progress.total,
-    completed: ++progress.completed,
+    total: props.progress.total,
+    completed: ++props.progress.completed,
     step: (ctx.state().analyze?.step ?? -1) + 1,
     created_at: new Date().toISOString(),
   };

package/src/orchestrate/analyze/orchestrateAnalyzeScenario.ts

@@ -6,10 +6,11 @@ import {
   AutoBeAnalyzeScenarioEvent,
   AutoBeAssistantMessageHistory,
 } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
@@ -29,25 +30,23 @@ export const orchestrateAnalyzeScenario = async <
     source: "analyzeScenario",
     controller: createController<Model>({
       model: ctx.model,
-      execute: new AutoBeAnalyzeScenarioApplication(),
-      preExecute: (props: IAutoBeAnalyzeScenarioApplication.IProps) =>
-        (pointer.value = props),
+      build: (value) => (pointer.value = value),
     }),
     histories: transformAnalyzeSceHistories(ctx),
     enforceFunctionCall: false,
-    message: [
-      `Design a complete list of documents and user roles for this project.`,
-      `Define user roles that can authenticate via API and create appropriate documentation files.`,
-      `You must respect the number of documents specified by the user.`,
-      `Note that the user's locale is in ${ctx.locale}.`,
-    ].join("\n"),
+    message: StringUtil.trim`
+      Design a complete list of documents and user roles for this project.
+      Define user roles that can authenticate via API and create appropriate documentation files.
+      You must respect the number of documents specified by the user.
+      Note that the user's locale is in ${ctx.locale}.
+    `,
   });
   if (histories.at(-1)?.type === "assistantMessage")
     return {
       ...(histories.at(-1)! as AgenticaAssistantMessageHistory),
       created_at: start.toISOString(),
       completed_at: new Date().toISOString(),
-      id: v4(),
+      id: v7(),
     } satisfies AutoBeAssistantMessageHistory;
   else if (pointer.value === null) {
     // unreachable
@@ -55,6 +54,7 @@ export const orchestrateAnalyzeScenario = async <
   }
   return {
     type: "analyzeScenario",
+    id: v7(),
     prefix: pointer.value.prefix,
     language: pointer.value.language,
     roles: pointer.value.roles,
@@ -65,33 +65,9 @@ export const orchestrateAnalyzeScenario = async <
   };
 };
 
-class AutoBeAnalyzeScenarioApplication
-  implements IAutoBeAnalyzeScenarioApplication
-{
-  /**
-   * Compose project structure with roles and files.
-   *
-   * Design a list of roles and initial documents that you need to create for
-   * that requirement. Roles define team member 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 roles. Simply pass an empty array to `input.files` and `input.roles`.
-   *
-   * @param input Prefix, roles, and files
-   * @returns
-   */
-  compose(input: IAutoBeAnalyzeScenarioApplication.IProps): void {
-    input;
-    return;
-  }
-}
-
 function createController<Model extends ILlmSchema.Model>(props: {
   model: Model;
-  execute: AutoBeAnalyzeScenarioApplication;
-  preExecute: (input: IAutoBeAnalyzeScenarioApplication.IProps) => void;
+  build: (value: IAutoBeAnalyzeScenarioApplication.IProps) => void;
 }): IAgenticaController.IClass<Model> {
   assertSchemaModel(props.model);
   const application: ILlmApplication<Model> = collection[
@@ -103,19 +79,21 @@ function createController<Model extends ILlmSchema.Model>(props: {
     application,
     execute: {
       compose: (input) => {
-        props.preExecute(input);
-        return props.execute.compose(input);
+        props.build(input);
       },
     } satisfies IAutoBeAnalyzeScenarioApplication,
   };
 }
 
 const claude = typia.llm.application<
-  AutoBeAnalyzeScenarioApplication,
+  IAutoBeAnalyzeScenarioApplication,
   "claude"
 >();
 const collection = {
-  chatgpt: typia.llm.application<AutoBeAnalyzeScenarioApplication, "chatgpt">(),
+  chatgpt: typia.llm.application<
+    IAutoBeAnalyzeScenarioApplication,
+    "chatgpt"
+  >(),
   claude,
   llama: claude,
   deepseek: claude,

package/src/orchestrate/analyze/orchestrateAnalyzeWrite.ts

@@ -2,11 +2,13 @@ import { IAgenticaController } from "@agentica/core";
 import {
   AutoBeAnalyzeScenarioEvent,
   AutoBeAnalyzeWriteEvent,
+  AutoBeProgressEventBase,
 } from "@autobe/interface";
 import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
@@ -15,31 +17,36 @@ import { IAutoBeAnalyzeWriteApplication } from "./structures/IAutoBeAnalyzeWrite
 
 export const orchestrateAnalyzeWrite = async <Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
-  scenario: AutoBeAnalyzeScenarioEvent,
-  file: AutoBeAnalyzeFile.Scenario,
-  progress: {
-    total: number;
-    completed: number;
+  props: {
+    scenario: AutoBeAnalyzeScenarioEvent;
+    file: AutoBeAnalyzeFile.Scenario;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
   },
 ): Promise<AutoBeAnalyzeWriteEvent> => {
+  const { scenario, file, progress, promptCacheKey } = props;
   const pointer: IPointer<IAutoBeAnalyzeWriteApplication.IProps | null> = {
     value: null,
   };
-  const { tokenUsage } = await ctx.conversate({
+  const { histories, tokenUsage } = await ctx.conversate({
     source: "analyzeWrite",
     controller: createController<Model>({
       model: ctx.model,
       pointer,
     }),
-    histories: transformAnalyzeWriteHistories(scenario, file),
+    histories: transformAnalyzeWriteHistories(ctx, scenario, file),
     enforceFunctionCall: true,
+    promptCacheKey,
     message: "Write requirement analysis report.",
   });
-  if (pointer.value === null)
+  if (pointer.value === null) {
+    console.log(JSON.stringify(histories, null, 2));
     throw new Error("The Analyze Agent failed to create the document.");
+  }
 
   const event: AutoBeAnalyzeWriteEvent = {
     type: "analyzeWrite",
+    id: v7(),
     file: {
       ...file,
       content: pointer.value.content,

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

@@ -12,9 +12,10 @@ export interface IAutoBeAnalyzeReviewApplication {
    * - Adding missing business processes and workflows
    * - Ensuring proper document structure and completeness
    *
-   * CRITICAL: The function outputs the actual document content that will be saved,
-   * not a review or analysis of the document. Any text output becomes part of
-   * the final document.
+   * 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
@@ -41,14 +42,12 @@ export namespace IAutoBeAnalyzeReviewApplication {
      *
      * Critical review points:
      *
-     * - Mermaid diagrams MUST use double quotes for ALL labels
-     * - No spaces allowed between brackets and quotes in Mermaid
-     * - Requirements must be specific and measurable in natural language
-     * - Focus on business requirements and user scenarios
-     * - STRICTLY PROHIBITED: Reject if document contains database schemas or API
-     *   specifications
-     * - Business model and authentication requirements must be described in
-     *   natural language
+     * - DO: Use double quotes for ALL labels in Mermaid diagrams
+     * - 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
      */
     review: string;
 
@@ -70,10 +69,11 @@ export namespace IAutoBeAnalyzeReviewApplication {
     /**
      * The actual markdown document content that incorporates review feedback.
      *
-     * ⚠️ CRITICAL: This field contains a COMPLETE MARKDOWN DOCUMENT that has 
-     * already incorporated the review criteria and plan requirements. This is 
-     * NOT raw input to be reviewed - it is the FINAL, PRODUCTION-READY DOCUMENT
-     * that reflects all review feedback and is immediately usable.
+     * 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)
@@ -92,7 +92,7 @@ export namespace IAutoBeAnalyzeReviewApplication {
      * - Appropriate level of detail for backend implementation
      * - Proper document linking (descriptive text, not raw filenames)
      *
-     * IMPORTANT: The enhancer's output IS this document, not comments about it:
+     * The enhancer outputs the document itself:
      *
      * - If content is provided, it represents the actual document
      * - The enhancer outputs the enhanced version AS the document itself

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

@@ -1,5 +1,6 @@
 import { AutoBeAnalyzeRole, CamelPattern } from "@autobe/interface";
 import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
+import { tags } from "typia";
 
 export interface IAutoBeAnalyzeScenarioApplication {
   /**
@@ -28,7 +29,7 @@ export namespace IAutoBeAnalyzeScenarioApplication {
      * Prefix for file names and variable names. This will be used for
      * organizing documentation files.
      *
-     * MUST use camelCase naming convention.
+     * DO: Use camelCase naming convention.
      */
     prefix: string & CamelPattern;
 
@@ -64,9 +65,8 @@ export namespace IAutoBeAnalyzeScenarioApplication {
      * - Service overview and business model description
      * - User roles and permission requirements (described in natural language)
      * - Business logic and validation rules
-     * - STRICTLY PROHIBITED: Do NOT include database schemas, ERD, or API
-     *   specifications
-     * - All requirements must be written in natural language for clarity
+     * - 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.
      * Do not create unnecessary documentation - only generate what is needed to
@@ -80,6 +80,6 @@ export namespace IAutoBeAnalyzeScenarioApplication {
      * user does not specify a number, generate a sufficient number of documents
      * to adequately support the service.
      */
-    files: Array<AutoBeAnalyzeFile.Scenario>;
+    files: Array<AutoBeAnalyzeFile.Scenario> & tags.MinItems<1>;
   }
 }

package/src/orchestrate/interface/histories/transformInterfaceAssetHistories.ts

@@ -4,7 +4,8 @@ import {
   AutoBePrismaHistory,
   IAutoBePrismaCompileResult,
 } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeState } from "../../../context/AutoBeState";
 
@@ -17,59 +18,58 @@ export const transformInterfaceAssetHistories = (
   const prisma: AutoBePrismaHistory = state.prisma!;
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "Requirement analysis and Prisma DB schema generation are ready.",
-        "",
-        "Call the provided tool function to generate the OpenAPI document",
-        "referencing below requirement analysis and Prisma DB schema.",
-        "",
-        // User Request
-        `## User Request`,
-        "",
-        analyze.reason,
-        "",
-        // Requirement Analysis Report
-        `## Requirement Analysis Report`,
-        "",
-        "```json",
-        JSON.stringify(analyze.files),
-        "```",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Requirement analysis and Prisma DB schema generation are ready.
+
+        Call the provided tool function to generate the OpenAPI document
+        referencing below requirement analysis and Prisma DB schema.
+
+        ## User Request
+
+        ${analyze.reason}
+
+        ## Requirement Analysis Report
+
+        \`\`\`json
+        ${JSON.stringify(analyze.files)}
+        \`\`\`
+      `,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "Database schema and entity relationship diagrams are ready.",
-        "You should also look at this and consider logic including membership/login and token issuance.",
-        "You can use table's name to define role in operations.",
-        "",
-        "## Critical Schema Verification Instructions",
-        "",
-        "**IMPORTANT**: When generating API operations and descriptions:",
-        "1. ONLY reference fields that ACTUALLY EXIST in the Prisma schema below",
-        "2. NEVER assume common fields like `deleted_at`, `created_by`, `updated_by`, `is_deleted` exist",
-        "3. For DELETE operations:",
-        "   - If schema HAS soft delete fields (e.g., `deleted_at`), describe soft delete behavior",
-        "   - If schema LACKS soft delete fields, describe hard delete behavior",
-        "4. Verify EVERY field reference against the actual schema before including in descriptions",
-        "",
-        "## Prisma DB Schema",
-        "```json",
-        JSON.stringify(prisma.schemas),
-        "```",
-        "",
-        "## Entity Relationship Diagrams",
-        "```json",
-        JSON.stringify(
+      text: StringUtil.trim`
+        Database schema and entity relationship diagrams are ready.
+        You should also look at this and consider logic including membership/login and token issuance.
+        You can use table's name to define role in operations.
+
+        ## Critical Schema Verification Instructions
+
+        **IMPORTANT**: When generating API operations and descriptions:
+        1. ONLY reference fields that ACTUALLY EXIST in the Prisma schema below
+        2. NEVER assume common fields like \`deleted_at\`, \`created_by\`, \`updated_by\`, \`is_deleted\` exist
+        3. For DELETE operations:
+           - If schema HAS soft delete fields (e.g., \`deleted_at\`), describe soft delete behavior
+           - If schema LACKS soft delete fields, describe hard delete behavior
+        4. Verify EVERY field reference against the actual schema before including in descriptions
+
+        ## Prisma DB Schema
+
+        \`\`\`json
+        ${JSON.stringify(prisma.schemas)}
+        \`\`\`
+
+        ## Entity Relationship Diagrams
+        \`\`\`json
+        ${JSON.stringify(
           (prisma.compiled as IAutoBePrismaCompileResult.ISuccess).diagrams,
-        ),
-        "```",
-      ].join("\n"),
+        )}
+        \`\`\`
+      `,
     },
   ];
 };

package/src/orchestrate/interface/histories/transformInterfaceAuthorizationsHistories.ts

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeAnalyzeRole } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeState } from "../../../context/AutoBeState";
@@ -15,26 +16,25 @@ export const transformInterfaceAuthorizationsHistories = (
   return [
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       text: AutoBeSystemPromptConstant.INTERFACE_AUTHORIZATION,
     },
     ...transformInterfaceAssetHistories(state),
     {
       type: "assistantMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      text: [
-        "You have to make API operations for the given role:",
-        "",
-        "## Role",
-        "",
-        "```json",
-        JSON.stringify(role),
-        "```",
-        "",
-        "",
-      ].join("\n"),
+      text: StringUtil.trim`
+        You have to make API operations for the given role:
+
+        ## Role
+
+        \`\`\`json
+        ${JSON.stringify(role)}
+        \`\`\`
+
+      `,
     },
   ];
 };