@autobe/agent 0.19.1 → 0.20.0

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,60 +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)}
+        \`\`\`
+
+      `,
     },
   ];
 };

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

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } 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,55 +16,55 @@ export const transformInterfaceComplementHistories = (
 > => [
   {
     type: "systemMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
     text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
   },
   ...transformInterfaceAssetHistories(state),
   {
-    type: "assistantMessage",
-    id: v4(),
+    type: "systemMessage",
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: [
-      "Here is the OpenAPI operations what you AI have made:",
-      "",
-      "```json",
-      JSON.stringify(document.operations),
-      "```",
-    ].join("\n"),
+    text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA,
   },
   {
     type: "systemMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA,
+    text: AutoBeSystemPromptConstant.INTERFACE_COMPLEMENT,
   },
   {
     type: "assistantMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: [
-      "Here is the OpenAPI schemas what you AI have made:",
-      "",
-      "```json",
-      JSON.stringify(document.components.schemas),
-      "```",
-    ].join("\n"),
+    text: StringUtil.trim`
+      Here is the OpenAPI operations what you AI have made:
+
+      \`\`\`json
+      ${JSON.stringify(document.operations)}
+      \`\`\`
+    `,
   },
   {
-    type: "systemMessage",
-    id: v4(),
+    type: "assistantMessage",
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: AutoBeSystemPromptConstant.INTERFACE_COMPLEMENT,
+    text: StringUtil.trim`
+      Here is the OpenAPI schemas what you AI have made:
+
+      \`\`\`json
+      ${JSON.stringify(document.components.schemas)}
+      \`\`\`
+    `,
   },
   {
     type: "assistantMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: [
-      "You AI have missed below schema types:",
-      "",
-      ...missed.map((s) => `- ${s}`),
-    ].join("\n"),
+    text: StringUtil.trim`
+      You AI have missed below schema types:
+
+      ${missed.map((s) => `- ${s}`).join("\n")}
+    `,
   },
 ];

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

@@ -1,7 +1,8 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } from "@autobe/interface";
 import { AutoBeInterfaceGroup } from "@autobe/interface/src/histories/contents/AutoBeInterfaceGroup";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeState } from "../../../context/AutoBeState";
@@ -16,36 +17,36 @@ export const transformInterfaceEndpointHistories = (
 > => [
   {
     type: "systemMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
     text: AutoBeSystemPromptConstant.INTERFACE_ENDPOINT,
   },
   ...transformInterfaceAssetHistories(state),
   {
     type: "assistantMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: [
-      "Here is the target group for the endpoints:",
-      "",
-      "```json",
-      JSON.stringify(group),
-      "```",
-      "",
-      "**IMPORTANT: DO NOT DUPLICATE EXISTING OPERATIONS**",
-      "",
-      "These operations already exist. Do NOT create similar endpoints:",
-      "",
-      "```json",
-      JSON.stringify(
+    text: StringUtil.trim`
+      Here is the target group for the endpoints:
+
+      \`\`\`json
+      ${JSON.stringify(group)}
+      \`\`\`
+
+      **IMPORTANT: DO NOT DUPLICATE EXISTING OPERATIONS**
+
+      These operations already exist. Do NOT create similar endpoints:
+
+      \`\`\`json
+      ${JSON.stringify(
         authorizations.map((op) => ({
           path: op.path,
           method: op.method,
           name: op.name,
           summary: op.summary,
         })),
-      ),
-      "```",
-    ].join("\n"),
+      )}
+      \`\`\`
+    `,
   },
 ];

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

@@ -1,5 +1,5 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeState } from "../../../context/AutoBeState";
@@ -16,14 +16,14 @@ export const transformInterfaceGroupHistories = (
 
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.INTERFACE_ENDPOINT,
     },
     ...transformInterfaceAssetHistories(state),
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.INTERFACE_GROUP,

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

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeAnalyzeHistory, AutoBeOpenApi } 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";
@@ -16,42 +17,42 @@ export const transformInterfaceOperationHistories = (
   return [
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
     },
     ...transformInterfaceAssetHistories(state),
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      text: [
-        `## Service Prefix`,
-        `- Original: ${analyze.prefix}`,
-        `- PascalCase for DTOs: ${analyze.prefix
+      text: StringUtil.trim`
+        ## Service Prefix
+        - Original: ${analyze.prefix}
+        - PascalCase for DTOs: ${analyze.prefix
           .split(/[-_]/)
           .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-          .join("")}`,
-        `- Expected DTO pattern: I${analyze.prefix
+          .join("")}
+        - Expected DTO pattern: I${analyze.prefix
           .split(/[-_]/)
           .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-          .join("")}{EntityName}`,
-      ].join("\n"),
+          .join("")}{EntityName}
+      `,
     },
     {
       type: "assistantMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      text: [
-        "You have to make API operations for the given endpoints:",
-        "",
-        "```json",
-        JSON.stringify(endpoints),
-        "```",
-        "",
-        "If there is a content in the failure, it is to explain why it failed before.",
-        "Please supplement or modify the Operation accordingly.",
-      ].join("\n"),
+      text: StringUtil.trim`
+        You have to make API operations for the given endpoints:
+
+        \`\`\`json
+        ${JSON.stringify(endpoints)}
+        \`\`\`
+
+        If there is a content in the failure, it is to explain why it failed before.
+        Please supplement or modify the Operation accordingly.
+      `,
     },
   ];
 };

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

@@ -1,7 +1,8 @@
 import { IMicroAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeContext } from "../../../context/AutoBeContext";
@@ -16,28 +17,28 @@ export function transformInterfaceOperationsReviewHistories<
   return [
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
     },
     ...transformInterfaceAssetHistories(ctx.state()),
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       text: AutoBeSystemPromptConstant.INTERFACE_OPERATION_REVIEW,
     },
     {
       type: "assistantMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      text: [
-        "Review the following API operations:",
-        "",
-        "```json",
-        JSON.stringify(operations),
-        "```",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Review the following API operations:
+
+        \`\`\`json
+        ${JSON.stringify(operations)}
+        \`\`\`
+      `,
     },
   ];
 }

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

@@ -1,5 +1,5 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeState } from "../../../context/AutoBeState";
 
@@ -11,7 +11,7 @@ export const transformInterfacePrerequisiteHistories = (
   if (state.analyze === null)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -24,7 +24,7 @@ export const transformInterfacePrerequisiteHistories = (
   else if (state.prisma === null)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -37,7 +37,7 @@ export const transformInterfacePrerequisiteHistories = (
   else if (state.analyze.step !== state.prisma.step)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -51,7 +51,7 @@ export const transformInterfacePrerequisiteHistories = (
   else if (state.prisma.compiled.type !== "success")
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [

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

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } 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";
@@ -14,21 +15,21 @@ export const transformInterfaceSchemaHistories = (
 > => [
   {
     type: "systemMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
     text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA,
   },
   ...transformInterfaceAssetHistories(state),
   {
     type: "assistantMessage",
-    id: v4(),
+    id: v7(),
     created_at: new Date().toISOString(),
-    text: [
-      "Here is the list of API operations you have to implement its types:",
-      "",
-      "```json",
-      JSON.stringify(operations),
-      "```",
-    ].join("\n"),
+    text: StringUtil.trim`
+      Here is the list of API operations you have to implement its types:
+
+      \`\`\`json
+      ${JSON.stringify(operations)}
+      \`\`\`
+    `,
   },
 ];

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

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } 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";
@@ -19,51 +20,51 @@ export const transformInterfaceSchemasReviewHistories = (
   return [
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA,
     },
     ...transformInterfaceAssetHistories(state),
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA_REVIEW,
     },
     {
       type: "assistantMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      text: [
-        "The Schema Agent has generated schemas for the following API operations.",
-        "These operations define what endpoints exist and what request/response types they use:",
-        "",
-        "```json",
-        JSON.stringify(operations),
-        "```",
-        "",
-        "All schema types referenced in these operations (in requestBody and responses) must exist in the schemas.",
-      ].join("\n"),
+      text: StringUtil.trim`
+        The Schema Agent has generated schemas for the following API operations.
+        These operations define what endpoints exist and what request/response types they use:
+
+        \`\`\`json
+        ${JSON.stringify(operations)}
+        \`\`\`
+
+        All schema types referenced in these operations (in requestBody and responses) must exist in the schemas.
+      `,
     },
     {
-      id: v4(),
+      id: v7(),
       type: "assistantMessage",
       created_at: new Date().toISOString(),
-      text: [
-        "Here are the schemas generated by the Schema Agent that need your review:",
-        "",
-        "```json",
-        JSON.stringify(schemaDescriptive),
-        "```",
-        "",
-        "Please review these schemas for:",
-        "1. Security vulnerabilities (passwords in responses, actor IDs in requests)",
-        "2. Missing entities or variants referenced by the operations",
-        "3. Type accuracy and format specifications",
-        "4. Alignment with Prisma schema and business requirements",
-        "",
-        "Fix all critical issues and return the enhanced schemas in the content field.",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Here are the schemas generated by the Schema Agent that need your review:
+
+        \`\`\`json
+        ${JSON.stringify(schemaDescriptive)}
+        \`\`\`
+
+        Please review these schemas for:
+        1. Security vulnerabilities (passwords in responses, actor IDs in requests)
+        2. Missing entities or variants referenced by the operations
+        3. Type accuracy and format specifications
+        4. Alignment with Prisma schema and business requirements
+
+        Fix all critical issues and return the enhanced schemas in the content field.
+      `,
     },
   ];
 };