@autobe/agent 0.18.0 → 0.20.0

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,46 +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,
         })),
-        null,
-        2,
-      ),
-      "```",
-      "",
-      "**DO NOT CREATE:**",
-      "- User creation endpoints (POST /users, POST /admins)",
-      "- Authentication endpoints (handled separately)",
-      "- Focus only on business data operations",
-      "",
-      "Create operations for DIFFERENT paths and DIFFERENT purposes only.",
-      "",
-    ].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, null, 2),
-        "```",
-      ].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,45 +20,51 @@ export const transformInterfaceSchemasReviewHistories = (
   return [
     {
       type: "systemMessage",
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
-      text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA_REVIEW,
+      text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA,
     },
     ...transformInterfaceAssetHistories(state),
+    {
+      type: "systemMessage",
+      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, null, 2),
-        "```",
-        "",
-        "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, null, 2),
-        "```",
-        "",
-        "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.
+      `,
     },
   ];
 };

package/src/orchestrate/interface/orchestrateInterface.ts

@@ -1,14 +1,19 @@
 import {
   AutoBeAssistantMessageHistory,
+  AutoBeInterfaceAuthorization,
   AutoBeInterfaceCompleteEvent,
   AutoBeInterfaceGroupsEvent,
   AutoBeInterfaceHistory,
   AutoBeOpenApi,
 } from "@autobe/interface";
+import { AutoBeEndpointComparator } from "@autobe/utils";
 import { ILlmSchema } from "@samchon/openapi";
+import { HashMap, Pair } from "tstl";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeApplicationProps } from "../../context/IAutoBeApplicationProps";
+import { predicateStateMessage } from "../../utils/predicateStateMessage";
 import { orchestrateInterfaceAuthorizations } from "./orchestrateInterfaceAuthorizations";
 import { orchestrateInterfaceComplement } from "./orchestrateInterfaceComplement";
 import { orchestrateInterfaceEndpoints } from "./orchestrateInterfaceEndpoints";
@@ -21,31 +26,65 @@ export const orchestrateInterface =
   async (
     props: IAutoBeApplicationProps,
   ): Promise<AutoBeAssistantMessageHistory | AutoBeInterfaceHistory> => {
-    // ENDPOINTS
+    // PREDICATION
     const start: Date = new Date();
+    const predicate: string | null = predicateStateMessage(
+      ctx.state(),
+      "interface",
+    );
+    if (predicate !== null)
+      return ctx.assistantMessage({
+        type: "assistantMessage",
+        id: v7(),
+        created_at: start.toISOString(),
+        text: predicate,
+        completed_at: new Date().toISOString(),
+      });
     ctx.dispatch({
       type: "interfaceStart",
+      id: v7(),
       created_at: start.toISOString(),
       reason: props.reason,
       step: ctx.state().analyze?.step ?? 0,
     });
 
-    const init: AutoBeAssistantMessageHistory | AutoBeInterfaceGroupsEvent =
+    // ENDPOINTS
+    const init: AutoBeInterfaceGroupsEvent =
       await orchestrateInterfaceGroups(ctx);
-    if (init.type === "assistantMessage") return ctx.assistantMessage(init);
-    else ctx.dispatch(init);
+    ctx.dispatch(init);
 
     // AUTHORIZATION
-    const authorizations: AutoBeOpenApi.IOperation[] =
+    const authorizations: AutoBeInterfaceAuthorization[] =
       await orchestrateInterfaceAuthorizations(ctx);
 
+    const authOperations = authorizations
+      .map((authorization) => authorization.operations)
+      .flat();
+
     // ENDPOINTS & OPERATIONS
     const endpoints: AutoBeOpenApi.IEndpoint[] =
-      await orchestrateInterfaceEndpoints(ctx, init.groups, authorizations);
-    const operations: AutoBeOpenApi.IOperation[] =
+      await orchestrateInterfaceEndpoints(ctx, init.groups, authOperations);
+    const firstOperations: AutoBeOpenApi.IOperation[] =
       await orchestrateInterfaceOperations(ctx, endpoints);
-
-    operations.push(...authorizations);
+    const operations: AutoBeOpenApi.IOperation[] = new HashMap<
+      AutoBeOpenApi.IEndpoint,
+      AutoBeOpenApi.IOperation
+    >(
+      [...authOperations, ...firstOperations].map(
+        (o) =>
+          new Pair(
+            {
+              path: o.path,
+              method: o.method,
+            },
+            o, // early inserted be kept
+          ),
+      ),
+      AutoBeEndpointComparator.hashCode,
+      AutoBeEndpointComparator.equals,
+    )
+      .toJSON()
+      .map((it) => it.second);
 
     // TYPE SCHEMAS
     const document: AutoBeOpenApi.IDocument = {
@@ -55,15 +94,17 @@ export const orchestrateInterface =
         schemas: await orchestrateInterfaceSchemas(ctx, operations),
       },
     };
-    document.components.schemas = await orchestrateInterfaceComplement(
-      ctx,
-      document,
+    Object.assign(
+      document.components.schemas,
+      await orchestrateInterfaceComplement(ctx, document),
     );
 
     // DO COMPILE
     return ctx.dispatch({
       type: "interfaceComplete",
+      id: v7(),
       document,
+      authorizations,
       created_at: new Date().toISOString(),
       elapsed: new Date().getTime() - start.getTime(),
       step: ctx.state().analyze?.step ?? 0,