feat(agent): separate interface schema review agent (#709)

* feat(agent): separate interface schema review agent

* rename events to be from plural to singular

* complete implementation

* complete UI

* renaming from relationship to relation

* Relation concept separating create/read DTOs

* complete complementation too

* fix typo

* change name again

* website again

* enhance agent system

* also migration

Author: samchon

packages/agent/prompts/INTERFACE_SCHEMA.md

@@ -174,30 +174,32 @@ const sleepMap: Record<AutoBeEvent.Type, number> = {
   analyzeComplete: 1_000,
   // PRISMA
   prismaStart: 1_000,
-  prismaComponents: 1_000,
-  prismaSchemas: 500,
+  prismaComponent: 1_000,
+  prismaSchema: 500,
   prismaInsufficient: 1_000,
   prismaReview: 500,
   prismaValidate: 2_000,
   prismaCorrect: 500,
   prismaComplete: 1_000,
   // INTERFACE
   interfaceStart: 1_000,
-  interfaceGroups: 1_000,
-  interfaceEndpoints: 1_000,
-  interfaceEndpointsReview: 1_000,
-  interfaceOperations: 400,
-  interfaceOperationsReview: 400,
+  interfaceGroup: 1_000,
+  interfaceEndpoint: 1_000,
+  interfaceEndpointReview: 1_000,
+  interfaceOperation: 400,
+  interfaceOperationReview: 400,
   interfaceAuthorization: 400,
-  interfaceSchemas: 400,
-  interfaceSchemasReview: 400,
+  interfaceSchema: 400,
+  interfaceSchemaSecurityReview: 400,
+  interfaceSchemaRelationReview: 400,
+  interfaceSchemaContentReview: 400,
   interfaceComplement: 2_000,
   interfaceComplete: 1_000,
-  interfacePrerequisites: 400,
+  interfacePrerequisite: 400,
   // TEST
   testStart: 1_000,
-  testScenarios: 40,
-  testScenariosReview: 40,
+  testScenario: 40,
+  testScenarioReview: 40,
   testWrite: 40,
   testValidate: 100,
   testCorrect: 100,

packages/agent/prompts/INTERFACE_SCHEMA_CONTENT_REVIEW.md

@@ -28,12 +28,6 @@ export const transformInterfaceComplementHistories = (props: {
     created_at: new Date().toISOString(),
     text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA,
   },
-  {
-    type: "systemMessage",
-    id: v7(),
-    created_at: new Date().toISOString(),
-    text: AutoBeSystemPromptConstant.INTERFACE_SCHEMA_REVIEW,
-  },
   {
     type: "systemMessage",
     id: v7(),

packages/agent/prompts/INTERFACE_SCHEMA_RELATION_REVIEW.md

@@ -10,6 +10,7 @@ import { transformInterfaceAssetHistories } from "./transformInterfaceAssetHisto
 export const transformInterfaceSchemaHistories = (props: {
   state: AutoBeState;
   operations: AutoBeOpenApi.IOperation[];
+  typeNames: string[];
   instruction: string;
 }): Array<
   IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
@@ -39,19 +40,23 @@ export const transformInterfaceSchemaHistories = (props: {
       such as endpoint patterns, request/response formats, DTO schemas,
       and operation specifications.
 
-      Follow these instructions when creating JSON schema components. 
+      Follow these instructions when creating JSON schema components.
       Carefully distinguish between:
       - Suggestions or recommendations (consider these as guidance)
       - Direct specifications or explicit commands (these must be followed exactly)
-      
-      When instructions contain direct specifications or explicit design decisions, 
+
+      When instructions contain direct specifications or explicit design decisions,
       follow them precisely even if you believe you have better alternatives.
 
       ${props.instruction}
 
-      ## Operations
+      ## Operations (Filtered for Target Schemas)
+
+      Here is the list of API operations that directly use the schemas
+      you need to generate (via requestBody.typeName or responseBody.typeName).
 
-      Here is the list of API operations you have to implement its types:
+      These are the ONLY operations relevant to your current task - other
+      operations have been filtered out to reduce noise and improve focus:
 
       \`\`\`json
       ${JSON.stringify(props.operations)}
@@ -60,8 +65,8 @@ export const transformInterfaceSchemaHistories = (props: {
       ## Schemas
 
       Here is the list of request/response bodies' type names from
-      OpenAPI operations. 
-      
+      OpenAPI operations.
+
       Reference them when creating DTO schema components, especially
       considering the DTO relationships.
 

packages/agent/prompts/INTERFACE_SCHEMA_REVIEW.md

@@ -0,0 +1,73 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+import { AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
+
+import { AutoBeState } from "../../../context/AutoBeState";
+import { transformInterfaceAssetHistories } from "./transformInterfaceAssetHistories";
+
+export const transformInterfaceSchemaReviewHistories = (props: {
+  state: AutoBeState;
+  systemPrompt: string;
+  operations: AutoBeOpenApi.IOperation[];
+  everySchemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>;
+  reviewSchemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>;
+}): Array<
+  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
+> => {
+  return [
+    {
+      type: "systemMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: props.systemPrompt,
+    },
+    ...transformInterfaceAssetHistories(props.state),
+    {
+      type: "assistantMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: StringUtil.trim`
+        ## Schemas (Complete Set for Reference)
+
+        Here is the COMPLETE set of all schemas in the system for
+        reference context:
+
+        \`\`\`json
+        ${JSON.stringify(props.everySchemas)}
+        \`\`\`
+      `,
+    },
+    {
+      id: v7(),
+      type: "assistantMessage",
+      created_at: new Date().toISOString(),
+      text: StringUtil.trim`
+        ## Schemas Needing Review
+
+        From the complete schema set above, here are the SPECIFIC schemas that need review:
+
+        \`\`\`json
+        ${JSON.stringify(props.reviewSchemas)}
+        \`\`\`
+
+        IMPORTANT: Only these ${Object.keys(props.reviewSchemas).length} schemas
+        need review and potential modification. The other schemas in
+        the full set are provided for reference only.
+
+        ## Operations (Filtered for Target Schemas)
+
+        Here are the API operations that directly use the schemas under review.
+        These operations reference at least one of the target schemas via
+        requestBody.typeName or responseBody.typeName.
+
+        This FILTERED list helps you understand the exact usage context for
+        the schemas you're reviewing:
+
+        \`\`\`json
+        ${JSON.stringify(props.operations)}
+        \`\`\`
+      `,
+    },
+  ];
+};