@autobe/agent 0.19.1 → 0.21.0

package/src/orchestrate/prisma/histories/transformPrismaComponentsHistories.ts

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
+import { StringUtil } from "@autobe/utils";
 import { NamingConvention } from "typia/lib/utils/NamingConvention";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeState } from "../../../context/AutoBeState";
@@ -17,67 +18,68 @@ export const transformPrismaComponentsHistories = (
   if (prefix) prefix = NamingConvention.snake(prefix);
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.PRISMA_COMPONENT,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "Here is the requirement analysis report.",
-        "",
-        "Call the provided tool function to generate Prisma DB schema",
-        "referencing below requirement analysis report.",
-        "",
-        `## Requirement Analysis Report`,
-        "",
-        "```json",
-        JSON.stringify(state.analyze.files),
-        "```",
-        "## Prefix",
-        "",
-        `* Prefix provided by the user: ${prefix}`,
-        "",
-        "The user wants all database schema (table) names to start with the prefix provided below.",
-        "",
-        "DO: Use the provided prefix for all table names",
-        "DO: Place special-purpose prefixes like `mv` (for materialized views) before the given prefix",
-        "DO NOT: Apply prefix if it is `null`",
-        "",
-        "## Prefix Example",
-        "",
-        "If the prefix is `shopping`, then table names are like:",
-        "",
-        "* `shopping_sales`",
-        "* `shopping_sale_options`",
-        "",
-        "In cases where a table is created for performance optimization purposes (e.g., materialized views), the `mv_` prefix must come first.",
-        "For example:",
-        "",
-        "* `mv_shopping_daily_stats`",
-        "",
-        "",
-        state.analyze.roles.length > 0
-          ? [
-              "## User Role Handling",
-              "",
-              `The Requirement Analysis Report contains the following user roles: ${state.analyze.roles.join(", ")}.`,
-              "",
-              "**Do not normalize** user roles into a single table.",
-              "Instead, create separate tables for each distinct role mentioned in the requirements.",
-              "",
-              "Create separate tables for each role:",
-              "",
-              state.analyze.roles
-                .map((role) => `* ${prefix}_${role.name.toLowerCase()}`)
-                .join("\n"),
-              "",
-            ].join("\n")
-          : "",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Here is the requirement analysis report.
+        
+        Call the provided tool function to generate Prisma DB schema
+        referencing below requirement analysis report.
+        
+        ## Requirement Analysis Report
+        
+        \`\`\`json
+        ${JSON.stringify(state.analyze.files)}
+        \`\`\`
+        
+        ## Prefix
+        
+        - Prefix provided by the user: ${prefix}
+        
+        The user wants all database schema (table) names to start with the prefix provided below.
+        
+        - DO: Use the provided prefix for all table names
+        - DO: Place special-purpose prefixes like \`mv\` (for materialized views) before the given prefix
+        - DO NOT: Apply prefix if it is \`null\`
+        
+        ## Prefix Example
+        
+        If the prefix is \`shopping\`, then table names are like:
+        
+        - \`shopping_sales\`
+        - \`shopping_sale_options\`
+        
+        In cases where a table is created for performance optimization purposes 
+        (e.g., materialized views), the \`mv_\` prefix must come first. For example:
+        
+        - \`mv_shopping_daily_stats\`
+        
+        ${
+          state.analyze.roles.length > 0
+            ? StringUtil.trim`
+                ## User Role Handling
+                
+                The Requirement Analysis Report contains the following user roles: ${state.analyze.roles.join(", ")}
+                
+                **Do not normalize** user roles into a single table.
+                Instead, create separate tables for each distinct role mentioned in the requirements.
+                
+                Create separate tables for each role:
+                
+                ${state.analyze.roles
+                  .map((role) => `- ${prefix}_${role.name.toLowerCase()}`)
+                  .join("\n")}
+              `
+            : ""
+        }
+      `,
     },
   ];
 };

package/src/orchestrate/prisma/histories/transformPrismaCorrectHistories.ts

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { IAutoBePrismaValidation } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 
@@ -11,46 +12,34 @@ export const transformPrismaCorrectHistories = (
 > => {
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.PRISMA_CORRECT,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "Here is the Prisma application data what you made:",
-        "",
-        "```json",
-        JSON.stringify(result.data),
-        "```",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Here is the Prisma application data what you made:
+        
+        \`\`\`json
+        ${JSON.stringify(result.data)}
+        \`\`\`
+      `,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "Below are the list of errors what you have to fix:",
-        "",
-        "```json",
-        JSON.stringify(result.errors),
-        "```",
-      ].join("\n"),
-    },
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: [
-        "Before fixing the schema files,",
-        "study about Prisma schema language",
-        "from the best practices and examples",
-        "",
-        AutoBeSystemPromptConstant.PRISMA_EXAMPLE,
-      ].join("\n"),
+      text: StringUtil.trim`
+        Below are the list of errors what you have to fix:
+        
+        \`\`\`json
+        ${JSON.stringify(result.errors)}
+        \`\`\`
+      `,
     },
   ];
 };

package/src/orchestrate/prisma/histories/transformPrismaReviewHistories.ts

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBePrisma } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 
@@ -14,53 +15,55 @@ export const transformPrismaReviewHistories = (props: {
 > => {
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.PRISMA_SCHEMA,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: [
-        "Here is the requirement analysis report given by the user:",
-        "",
-        "```json",
-        JSON.stringify(props.analysis),
-        "```",
-        "",
-        "Reading the requirement analysis report, you AI made below AST definition for the database design:",
-        "",
-        "```json",
-        JSON.stringify(props.application),
-        "```",
-        "",
-        "And here are the Prisma schema files generated (compiled) from the above AST:",
-        "",
-        "```prisma",
-        JSON.stringify(props.schemas),
-        "```",
-      ].join("\n"),
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.PRISMA_REVIEW,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.PRISMA_REVIEW,
+      type: "assistantMessage",
+      text: StringUtil.trim`
+        Here is the requirement analysis report given by the user:
+        
+        \`\`\`json
+        ${JSON.stringify(props.analysis)}
+        \`\`\`
+        
+        Reading the requirement analysis report, you AI made 
+        below AST definition for the database design:
+        
+        \`\`\`json
+        ${JSON.stringify(props.application)}
+        \`\`\`
+        
+        And here are the Prisma schema files generated (compiled) 
+        from the above AST:
+        
+        \`\`\`json
+        ${JSON.stringify(props.schemas)}
+        \`\`\`
+      `,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        `Now, please review the tables in the "${props.component.namespace}" namespace.`,
-        "",
-        "Focus your review exclusively on these tables.",
-        "",
-        "**Tables in this namespace:**",
-        ...props.component.tables.map((table) => `- ${table}`),
-      ].join("\n"),
+      text: StringUtil.trim`
+        Now, please review the tables in the "${props.component.namespace}" namespace.
+        
+        Focus your review exclusively on these tables.
+        
+        **Tables in this namespace:**
+        ${props.component.tables.map((table) => `- ${table}`).join("\n")}
+      `,
     },
   ];
 };

package/src/orchestrate/prisma/histories/transformPrismaSchemaHistories.ts

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBePrisma } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 
@@ -13,42 +14,54 @@ export const transformPrismaSchemaHistories = (
 > => {
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.PRISMA_SCHEMA,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "Here is the input data for generating Prisma DB schema.",
-        "",
-        "```",
-        JSON.stringify({
-          requirementAnalysisReport,
+      text: StringUtil.trim`
+        Here is the requirement analysis report:
+
+        \`\`\`json
+        ${JSON.stringify(requirementAnalysisReport)}
+        \`\`\`
+      `,
+    },
+    {
+      id: v7(),
+      created_at: new Date().toISOString(),
+      type: "assistantMessage",
+      text: StringUtil.trim`
+        Here is the input data for generating Prisma DB schema.
+        
+        \`\`\`json
+        ${JSON.stringify({
           targetComponent,
           otherTables,
-        }),
-        "```",
-      ].join("\n"),
+        })}
+        \`\`\`
+      `,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
-      text: [
-        "You've already taken a mistake that creating models from the other components.",
-        "Note that, you have to make models from the target component only. Never make",
-        "models from the other components. The other components' models are already made.",
-        "",
-        "```json",
-        JSON.stringify({
+      text: StringUtil.trim`
+        You've already taken a mistake that creating models from the other components.
+
+        Note that, you have to make models from the target component only. Never make
+        models from the other components. The other components' models are already made.
+        
+        \`\`\`json
+        ${JSON.stringify({
           targetComponent,
-        }),
-        "```",
-      ].join("\n"),
+        })}
+        \`\`\`
+      `,
     },
   ];
 };

package/src/orchestrate/prisma/orchestratePrisma.ts

@@ -10,7 +10,7 @@ import {
 } from "@autobe/interface";
 import { AutoBePrismaSchemasEvent } from "@autobe/interface/src/events/AutoBePrismaSchemasEvent";
 import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeApplicationProps } from "../../context/IAutoBeApplicationProps";
@@ -30,13 +30,14 @@ export const orchestratePrisma = async <Model extends ILlmSchema.Model>(
   if (predicate !== null)
     return ctx.assistantMessage({
       type: "assistantMessage",
-      id: v4(),
+      id: v7(),
       created_at: start.toISOString(),
       text: predicate,
       completed_at: new Date().toISOString(),
     });
   ctx.dispatch({
     type: "prismaStart",
+    id: v7(),
     created_at: start.toISOString(),
     reason: props.reason,
     step: ctx.state().analyze?.step ?? 0,
@@ -93,6 +94,7 @@ export const orchestratePrisma = async <Model extends ILlmSchema.Model>(
   // PROPAGATE
   return ctx.dispatch({
     type: "prismaComplete",
+    id: v7(),
     result,
     schemas: finalSchemas,
     compiled: await compiler.prisma.compile({

package/src/orchestrate/prisma/orchestratePrismaComponent.ts

@@ -3,6 +3,7 @@ import { AutoBePrismaComponentsEvent } from "@autobe/interface/src/events/AutoBe
 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";
@@ -36,6 +37,7 @@ export async function orchestratePrismaComponents<
     throw new Error("Failed to extract files and tables."); // unreachable
   return {
     type: "prismaComponents",
+    id: v7(),
     created_at: start.toISOString(),
     thinking: pointer.value.thinking,
     review: pointer.value.review,

package/src/orchestrate/prisma/orchestratePrismaCorrect.ts

@@ -8,6 +8,7 @@ import {
 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";
@@ -49,6 +50,7 @@ async function iterate<Model extends ILlmSchema.Model>(
   );
   ctx.dispatch({
     type: "prismaValidate",
+    id: v7(),
     result,
     schemas,
     compiled: await compiler.prisma.compile({
@@ -144,6 +146,7 @@ async function execute<Model extends ILlmSchema.Model>(
   };
   ctx.dispatch({
     type: "prismaCorrect",
+    id: v7(),
     failure,
     planning: pointer.value.planning,
     correction: correction,

package/src/orchestrate/prisma/orchestratePrismaReview.ts

@@ -4,9 +4,11 @@ import { AutoBePrismaReviewEvent } from "@autobe/interface/src/events/AutoBePris
 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 { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { transformPrismaReviewHistories } from "./histories/transformPrismaReviewHistories";
 import { IAutoBePrismaReviewApplication } from "./structures/IAutoBePrismaReviewApplication";
 
@@ -21,10 +23,16 @@ export async function orchestratePrismaReview<Model extends ILlmSchema.Model>(
     total: componentList.length,
   };
   return (
-    await Promise.all(
-      componentList.map(async (component) => {
+    await executeCachedBatch(
+      componentList.map((component) => async (promptCacheKey) => {
         try {
-          return await step(ctx, application, schemas, component, progress);
+          return await step(ctx, {
+            application,
+            schemas,
+            component,
+            progress,
+            promptCacheKey,
+          });
         } catch {
           ++progress.completed;
           return null;
@@ -36,10 +44,13 @@ export async function orchestratePrismaReview<Model extends ILlmSchema.Model>(
 
 async function step<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
-  application: AutoBePrisma.IApplication,
-  schemas: Record<string, string>,
-  component: AutoBePrisma.IComponent,
-  progress: AutoBeProgressEventBase,
+  props: {
+    application: AutoBePrisma.IApplication;
+    schemas: Record<string, string>;
+    component: AutoBePrisma.IComponent;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
+  },
 ): Promise<AutoBePrismaReviewEvent> {
   const start: Date = new Date();
   const pointer: IPointer<IAutoBePrismaReviewApplication.IProps | null> = {
@@ -55,9 +66,9 @@ async function step<Model extends ILlmSchema.Model>(
           .reduce((acc, cur) => {
             return Object.assign(acc, cur);
           }, {}) ?? {},
-      application,
-      schemas,
-      component,
+      application: props.application,
+      schemas: props.schemas,
+      component: props.component,
     }),
     controller: createController(ctx, {
       build: (next) => {
@@ -65,6 +76,7 @@ async function step<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
+    promptCacheKey: props.promptCacheKey,
     message: "Please review the Prisma schema file.",
   });
   if (pointer.value === null)
@@ -72,14 +84,15 @@ async function step<Model extends ILlmSchema.Model>(
 
   const event: AutoBePrismaReviewEvent = {
     type: "prismaReview",
+    id: v7(),
     created_at: start.toISOString(),
-    filename: component.filename,
+    filename: props.component.filename,
     review: pointer.value.review,
     plan: pointer.value.plan,
     modifications: pointer.value.modifications,
     tokenUsage,
-    completed: ++progress.completed,
-    total: progress.total,
+    completed: ++props.progress.completed,
+    total: props.progress.total,
     step: ctx.state().analyze?.step ?? 0,
   };
   ctx.dispatch(event);

package/src/orchestrate/prisma/orchestratePrismaSchemas.ts

@@ -1,12 +1,15 @@
 import { IAgenticaController } from "@agentica/core";
 import { AutoBePrisma } from "@autobe/interface";
 import { AutoBePrismaSchemasEvent } from "@autobe/interface/src/events/AutoBePrismaSchemasEvent";
+import { StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmSchema, IValidation } 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 { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { transformPrismaSchemaHistories } from "./histories/transformPrismaSchemaHistories";
 import { IAutoBePrismaSchemaApplication } from "./structures/IAutoBePrismaSchemaApplication";
 
@@ -19,8 +22,8 @@ export async function orchestratePrismaSchemas<Model extends ILlmSchema.Model>(
     .map((c) => c.tables.length)
     .reduce((x, y) => x + y, 0);
   const completed: IPointer<number> = { value: 0 };
-  return await Promise.all(
-    componentList.map(async (component) => {
+  return await executeCachedBatch(
+    componentList.map((component) => async (promptCacheKey) => {
       const otherTables: string[] = componentList
         .filter((y) => component !== y)
         .map((c) => c.tables)
@@ -31,6 +34,7 @@ export async function orchestratePrismaSchemas<Model extends ILlmSchema.Model>(
         start,
         total,
         completed,
+        promptCacheKey,
       });
       ctx.dispatch(event);
       return event;
@@ -46,6 +50,7 @@ async function process<Model extends ILlmSchema.Model>(
     start: Date;
     total: number;
     completed: IPointer<number>;
+    promptCacheKey: string;
   },
 ): Promise<AutoBePrismaSchemasEvent> {
   const pointer: IPointer<IAutoBePrismaSchemaApplication.IProps | null> = {
@@ -71,12 +76,14 @@ async function process<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
+    promptCacheKey: props.promptCacheKey,
     message: "Make prisma schema file please",
   });
   if (pointer.value === null)
     throw new Error("Unreachable code: Prisma Schema not generated");
   return {
     type: "prismaSchemas",
+    id: v7(),
     created_at: props.start.toISOString(),
     plan: pointer.value.plan,
     models: pointer.value.models,
@@ -118,6 +125,7 @@ function createController<Model extends ILlmSchema.Model>(
 
     ctx.dispatch({
       type: "prismaInsufficient",
+      id: v7(),
       created_at: new Date().toISOString(),
       component: props.targetComponent,
       actual,
@@ -131,26 +139,26 @@ function createController<Model extends ILlmSchema.Model>(
           path: "$input.models",
           value: result.data.models,
           expected: `Array<AutoBePrisma.IModel>`,
-          description: [
-            "You missed some tables from the current domain's component.",
-            "",
-            "Look at the following details to fix the schemas. Never forget to",
-            "compose the `missed` tables at the next function calling.",
-            "",
-            "- filename: current domain's filename",
-            "- namespace: current domain's namespace",
-            "- expected: expected tables in the current domain",
-            "- actual: actual tables you made",
-            "- missed: tables you have missed, and you have to compose again",
-            "",
-            JSON.stringify({
+          description: StringUtil.trim`
+            You missed some tables from the current domain's component.
+
+            Look at the following details to fix the schemas. Never forget to
+            compose the \`missed\` tables at the next function calling.
+
+            - filename: current domain's filename
+            - namespace: current domain's namespace
+            - expected: expected tables in the current domain
+            - actual: actual tables you made
+            - missed: tables you have missed, and you have to compose again
+
+            ${JSON.stringify({
               filename: props.targetComponent.filename,
               namespace: props.targetComponent.namespace,
               expected,
               actual,
               missed,
-            }),
-          ].join("\n"),
+            })}
+          `,
         },
       ],
     };