@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/orchestrate/facade/histories/IAutoBeFacadeApplication.ts

@@ -1,139 +1,139 @@
-import { IAutoBeFacadeApplicationResult } from "./IAutoBeFacadeApplicationResult";
-
-/**
- * Application for AutoBE function calling.
- *
- * @author Samchon
- */
-export interface IAutoBeFacadeApplication {
-  /**
-   * Run Analyze Agent.
-   *
-   * Executes the Analyze agent to process user requirements and generate a
-   * structured specification document. This agent analyzes all conversation
-   * history between users and AI, separates business logic from technical
-   * requirements, and establishes development priorities and scope.
-   *
-   * **IMPORTANT**: Only call this function when sufficient requirements have
-   * been discussed to generate a comprehensive specification. The context must
-   * contain enough detail about the system's purpose, core features, data
-   * models, and business rules. If requirements are unclear or incomplete,
-   * continue gathering information through conversation instead.
-   *
-   * The agent will automatically generate follow-up questions for any ambiguous
-   * requirements and continuously refine its understanding through iterative
-   * conversation. When executed after other agents have generated code, it can
-   * also interpret change requests in the context of existing implementations.
-   */
-  analyze(): Promise<IAutoBeFacadeApplicationResult>;
-
-  /**
-   * Run database agent.
-   *
-   * Executes the Database agent to generate database schema files and ERD
-   * documentation. This agent reads the requirements specification created by
-   * the {@link analyze Analyze agent} and produces a complete database schema
-   * with comprehensive documentation for each entity and attribute.
-   *
-   * **PREREQUISITE**: Only call this function after the {@link analyze} function
-   * has been successfully executed and a requirements specification document
-   * has been generated. The Database agent depends on the structured
-   * requirements analysis to design the database schema properly. Without a
-   * completed requirements specification, this function should NOT be called.
-   *
-   * The agent will automatically validate the generated schema using the
-   * database schema compilation, self-correct any compilation errors through
-   * feedback loops, and generate ERD documentation using prisma-markdown. An
-   * internal review process ensures schema quality and optimization.
-   */
-  database(props: {
-    /**
-     * Database design instructions from user conversation.
-     *
-     * Pass empty string "" if no database-specific instructions exist.
-     */
-    instruction: string;
-  }): Promise<IAutoBeFacadeApplicationResult>;
-
-  /**
-   * Run interface agent.
-   *
-   * Executes the Interface agent to design and generate API interfaces. This
-   * agent creates OpenAPI schemas and TypeScript/NestJS code based on the
-   * requirements specification and ERD documentation from previous agents.
-   *
-   * The agent follows a sophisticated pipeline: first constructing formal
-   * OpenAPI Operation Schemas and JSON Schemas, then validating these schemas,
-   * and finally transforming them into NestJS controllers and DTOs. Each
-   * generated interface includes comprehensive JSDoc comments and undergoes
-   * internal review for consistency.
-   */
-  interface(props: {
-    /**
-     * API design instructions from user conversation.
-     *
-     * Pass empty string "" if no API-specific instructions exist.
-     */
-    instruction: string;
-  }): Promise<IAutoBeFacadeApplicationResult>;
-
-  /**
-   * Run test program agent.
-   *
-   * Executes the Test agent to generate comprehensive E2E test suites for all
-   * {@link interface API interfaces}. This agent synthesizes outputs from
-   * previous agents to create tests that validate both individual endpoints and
-   * their interactions.
-   *
-   * **PREREQUISITE**: Only call this function after the {@link interface}
-   * function has been successfully executed and API interfaces have been
-   * generated. The Test agent requires the completed API interface definitions,
-   * OpenAPI schemas, and TypeScript code to generate appropriate test
-   * scenarios. Without completed interface design, this function should NOT be
-   * called.
-   *
-   * The agent will analyze dependency relationships between API functions,
-   * structure integrated test scenarios with correct execution sequences, and
-   * enhance pre-generated test scaffolds with business logic validation.
-   * TypeScript compiler validation and internal review ensure test quality and
-   * optimal coverage.
-   */
-  test(props: {
-    /**
-     * Testing strategy instructions from user conversation.
-     *
-     * Pass empty string "" if no test-specific instructions exist.
-     */
-    instruction: string;
-  }): Promise<IAutoBeFacadeApplicationResult>;
-
-  /**
-   * Run realize agent.
-   *
-   * Executes the Realize agent to implement the actual business logic for each
-   * API endpoint. This agent synthesizes all outputs from previous agents to
-   * generate fully functional service provider code.
-   *
-   * **PREREQUISITE**: Only call this function after the {@link interface}
-   * function has been successfully executed and API interfaces have been
-   * generated. The Realize agent requires the completed API interface
-   * definitions to implement the corresponding service logic. It also benefits
-   * from having test code available for validation. Without completed interface
-   * design, this function should NOT be called.
-   *
-   * The agent will create service implementations with multiple validation
-   * layers: TypeScript compiler feedback, runtime validation through test
-   * execution, and quality optimization through internal review. The generated
-   * code handles database interactions through Database, implements security
-   * and validation checks, and processes business rules according to
-   * specifications.
-   */
-  realize(props: {
-    /**
-     * Implementation instructions from user conversation.
-     *
-     * Pass empty string "" if no implementation-specific instructions exist.
-     */
-    instruction: string;
-  }): Promise<IAutoBeFacadeApplicationResult>;
-}
+import { IAutoBeFacadeApplicationResult } from "./IAutoBeFacadeApplicationResult";
+
+/**
+ * Application for AutoBE function calling.
+ *
+ * @author Samchon
+ */
+export interface IAutoBeFacadeApplication {
+  /**
+   * Run Analyze Agent.
+   *
+   * Executes the Analyze agent to process user requirements and generate a
+   * structured specification document. This agent analyzes all conversation
+   * history between users and AI, separates business logic from technical
+   * requirements, and establishes development priorities and scope.
+   *
+   * **IMPORTANT**: Only call this function when sufficient requirements have
+   * been discussed to generate a comprehensive specification. The context must
+   * contain enough detail about the system's purpose, core features, data
+   * models, and business rules. If requirements are unclear or incomplete,
+   * continue gathering information through conversation instead.
+   *
+   * The agent will automatically generate follow-up questions for any ambiguous
+   * requirements and continuously refine its understanding through iterative
+   * conversation. When executed after other agents have generated code, it can
+   * also interpret change requests in the context of existing implementations.
+   */
+  analyze(): Promise<IAutoBeFacadeApplicationResult>;
+
+  /**
+   * Run database agent.
+   *
+   * Executes the Database agent to generate database schema files and ERD
+   * documentation. This agent reads the requirements specification created by
+   * the {@link analyze Analyze agent} and produces a complete database schema
+   * with comprehensive documentation for each entity and attribute.
+   *
+   * **PREREQUISITE**: Only call this function after the {@link analyze} function
+   * has been successfully executed and a requirements specification document
+   * has been generated. The Database agent depends on the structured
+   * requirements analysis to design the database schema properly. Without a
+   * completed requirements specification, this function should NOT be called.
+   *
+   * The agent will automatically validate the generated schema using the
+   * database schema compilation, self-correct any compilation errors through
+   * feedback loops, and generate ERD documentation using prisma-markdown. An
+   * internal review process ensures schema quality and optimization.
+   */
+  database(props: {
+    /**
+     * Database design instructions from user conversation.
+     *
+     * Pass empty string "" if no database-specific instructions exist.
+     */
+    instruction: string;
+  }): Promise<IAutoBeFacadeApplicationResult>;
+
+  /**
+   * Run interface agent.
+   *
+   * Executes the Interface agent to design and generate API interfaces. This
+   * agent creates OpenAPI schemas and TypeScript/NestJS code based on the
+   * requirements specification and ERD documentation from previous agents.
+   *
+   * The agent follows a sophisticated pipeline: first constructing formal
+   * OpenAPI Operation Schemas and JSON Schemas, then validating these schemas,
+   * and finally transforming them into NestJS controllers and DTOs. Each
+   * generated interface includes comprehensive JSDoc comments and undergoes
+   * internal review for consistency.
+   */
+  interface(props: {
+    /**
+     * API design instructions from user conversation.
+     *
+     * Pass empty string "" if no API-specific instructions exist.
+     */
+    instruction: string;
+  }): Promise<IAutoBeFacadeApplicationResult>;
+
+  /**
+   * Run test program agent.
+   *
+   * Executes the Test agent to generate comprehensive E2E test suites for all
+   * {@link interface API interfaces}. This agent synthesizes outputs from
+   * previous agents to create tests that validate both individual endpoints and
+   * their interactions.
+   *
+   * **PREREQUISITE**: Only call this function after the {@link interface}
+   * function has been successfully executed and API interfaces have been
+   * generated. The Test agent requires the completed API interface definitions,
+   * OpenAPI schemas, and TypeScript code to generate appropriate test
+   * scenarios. Without completed interface design, this function should NOT be
+   * called.
+   *
+   * The agent will analyze dependency relationships between API functions,
+   * structure integrated test scenarios with correct execution sequences, and
+   * enhance pre-generated test scaffolds with business logic validation.
+   * TypeScript compiler validation and internal review ensure test quality and
+   * optimal coverage.
+   */
+  test(props: {
+    /**
+     * Testing strategy instructions from user conversation.
+     *
+     * Pass empty string "" if no test-specific instructions exist.
+     */
+    instruction: string;
+  }): Promise<IAutoBeFacadeApplicationResult>;
+
+  /**
+   * Run realize agent.
+   *
+   * Executes the Realize agent to implement the actual business logic for each
+   * API endpoint. This agent synthesizes all outputs from previous agents to
+   * generate fully functional service provider code.
+   *
+   * **PREREQUISITE**: Only call this function after the {@link interface}
+   * function has been successfully executed and API interfaces have been
+   * generated. The Realize agent requires the completed API interface
+   * definitions to implement the corresponding service logic. It also benefits
+   * from having test code available for validation. Without completed interface
+   * design, this function should NOT be called.
+   *
+   * The agent will create service implementations with multiple validation
+   * layers: TypeScript compiler feedback, runtime validation through test
+   * execution, and quality optimization through internal review. The generated
+   * code handles database interactions through Database, implements security
+   * and validation checks, and processes business rules according to
+   * specifications.
+   */
+  realize(props: {
+    /**
+     * Implementation instructions from user conversation.
+     *
+     * Pass empty string "" if no implementation-specific instructions exist.
+     */
+    instruction: string;
+  }): Promise<IAutoBeFacadeApplicationResult>;
+}

package/src/orchestrate/facade/histories/IAutoBeFacadeApplicationProps.ts

@@ -1,8 +1,8 @@
-export interface IAutoBeFacadeApplicationProps {
-  /**
-   * Instructions for each agent phase redefined by AI from user's utterance.
-   * Contains specific guidance for analyze/database/interface/test/realize
-   * agents.
-   */
-  instruction: string;
-}
+export interface IAutoBeFacadeApplicationProps {
+  /**
+   * Instructions for each agent phase redefined by AI from user's utterance.
+   * Contains specific guidance for analyze/database/interface/test/realize
+   * agents.
+   */
+  instruction: string;
+}

package/src/orchestrate/facade/histories/IAutoBeFacadeApplicationResult.ts

@@ -1,9 +1,9 @@
-export interface IAutoBeFacadeApplicationResult {
-  type:
-    | "success"
-    | "failure"
-    | "exception"
-    | "in-progress"
-    | "prerequisites-not-satisfied";
-  description: string;
-}
+export interface IAutoBeFacadeApplicationResult {
+  type:
+    | "success"
+    | "failure"
+    | "exception"
+    | "in-progress"
+    | "prerequisites-not-satisfied";
+  description: string;
+}

package/src/orchestrate/facade/structures/transformFacadeStateMessage.ts

@@ -1,59 +1,59 @@
-import { StringUtil } from "@autobe/utils";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { AutoBeState } from "../../../context/AutoBeState";
-
-export function transformFacadeStateMessage(state: AutoBeState): string {
-  const currentState: ICurrentState = getCurrentState(state);
-  return AutoBeSystemPromptConstant.AGENTICA_FACADE.replace(
-    "{% STATE %}",
-    StringUtil.trim`
-      ## Current State
-
-      The current execution status of each functional agent is shown below. 
-      Each agent can be in one of three states: "none" (never executed), 
-      "up-to-date" (successfully executed with current output), 
-      or "out-of-date" (previously executed but needs updating due to 
-      changes in earlier stages).
-
-      An agent cannot be executed if any of its prerequisite agents have
-      a status of "none" or "out-of-date". In such cases, you must complete or
-      update the earlier stages first. Additionally, re-executing an "up-to-date"
-      agent will cause all subsequent agents to become "out-of-date", as they
-      depend on the updated output.
-
-      - analyze: ${currentState.analyze}
-      - database: ${currentState.database}
-      - interface: ${currentState.interface}
-      - test: ${currentState.test}
-      - realize: ${currentState.realize}
-    `,
-  );
-}
-
-function getCurrentState(state: AutoBeState): ICurrentState {
-  const value = (
-    obj: {
-      step: number;
-    } | null,
-  ) => {
-    if (state.analyze === null || obj === null) return "none";
-    else if (state.analyze.step === obj.step) return "up-to-date";
-    else return "out-of-date";
-  };
-  return {
-    analyze: state.analyze === null ? "none" : "up-to-date",
-    database: value(state.database),
-    interface: value(state.interface),
-    test: value(state.test),
-    realize: value(state.realize),
-  };
-}
-
-interface ICurrentState {
-  analyze: "up-to-date" | "none";
-  database: "up-to-date" | "out-of-date" | "none";
-  interface: "up-to-date" | "out-of-date" | "none";
-  test: "up-to-date" | "out-of-date" | "none";
-  realize: "up-to-date" | "out-of-date" | "none";
-}
+import { StringUtil } from "@autobe/utils";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { AutoBeState } from "../../../context/AutoBeState";
+
+export function transformFacadeStateMessage(state: AutoBeState): string {
+  const currentState: ICurrentState = getCurrentState(state);
+  return AutoBeSystemPromptConstant.AGENTICA_FACADE.replace(
+    "{% STATE %}",
+    StringUtil.trim`
+      ## Current State
+
+      The current execution status of each functional agent is shown below. 
+      Each agent can be in one of three states: "none" (never executed), 
+      "up-to-date" (successfully executed with current output), 
+      or "out-of-date" (previously executed but needs updating due to 
+      changes in earlier stages).
+
+      An agent cannot be executed if any of its prerequisite agents have
+      a status of "none" or "out-of-date". In such cases, you must complete or
+      update the earlier stages first. Additionally, re-executing an "up-to-date"
+      agent will cause all subsequent agents to become "out-of-date", as they
+      depend on the updated output.
+
+      - analyze: ${currentState.analyze}
+      - database: ${currentState.database}
+      - interface: ${currentState.interface}
+      - test: ${currentState.test}
+      - realize: ${currentState.realize}
+    `,
+  );
+}
+
+function getCurrentState(state: AutoBeState): ICurrentState {
+  const value = (
+    obj: {
+      step: number;
+    } | null,
+  ) => {
+    if (state.analyze === null || obj === null) return "none";
+    else if (state.analyze.step === obj.step) return "up-to-date";
+    else return "out-of-date";
+  };
+  return {
+    analyze: state.analyze === null ? "none" : "up-to-date",
+    database: value(state.database),
+    interface: value(state.interface),
+    test: value(state.test),
+    realize: value(state.realize),
+  };
+}
+
+interface ICurrentState {
+  analyze: "up-to-date" | "none";
+  database: "up-to-date" | "out-of-date" | "none";
+  interface: "up-to-date" | "out-of-date" | "none";
+  test: "up-to-date" | "out-of-date" | "none";
+  realize: "up-to-date" | "out-of-date" | "none";
+}

package/src/orchestrate/index.ts

@@ -1,5 +1,5 @@
-export * from "./analyze/index";
-export * from "./prisma/index";
-export * from "./interface/index";
-export * from "./test/index";
-export * from "./realize/index";
+export * from "./analyze/index";
+export * from "./prisma/index";
+export * from "./interface/index";
+export * from "./test/index";
+export * from "./realize/index";

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

@@ -1,83 +1,83 @@
-import {
-  AutoBeInterfaceEndpointDesign,
-  AutoBeInterfaceGroup,
-  AutoBeOpenApi,
-} from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
-import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
-import { transformInterfaceEndpointAuthorizationSection } from "./transformInterfaceEndpointAuthorizationSection";
-
-export const transformInterfaceActionEndpointReviewHistory = (props: {
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-    | "previousInterfaceOperations"
-  >;
-  designs: AutoBeInterfaceEndpointDesign[];
-  baseEndpoints: AutoBeOpenApi.IEndpoint[];
-  group: AutoBeInterfaceGroup;
-  authorizeOperations: AutoBeOpenApi.IOperation[];
-}): IAutoBeOrchestrateHistory => ({
-  histories: [
-    {
-      type: "systemMessage",
-      id: v7(),
-      created_at: new Date().toISOString(),
-      text: AutoBeSystemPromptConstant.INTERFACE_ACTION_ENDPOINT_WRITE,
-    },
-    {
-      type: "systemMessage",
-      id: v7(),
-      created_at: new Date().toISOString(),
-      text: AutoBeSystemPromptConstant.INTERFACE_ACTION_ENDPOINT_REVIEW,
-    },
-    ...props.preliminary.getHistories(),
-    {
-      id: v7(),
-      type: "assistantMessage",
-      text: StringUtil.trim`
-        ## Base CRUD Endpoints (Reference - Already Exist)
-
-        These base CRUD endpoints already exist. For reference only:
-
-        \`\`\`json
-        ${JSON.stringify(props.baseEndpoints)}
-        \`\`\`
-
-        ## Target Group
-
-        You are reviewing endpoints for the **${props.group.name}** group.
-
-        - **Description**: ${props.group.description}
-        - **Related Database Schemas**: ${props.group.databaseSchemas.join(", ")}
-
-        ${transformInterfaceEndpointAuthorizationSection(props.authorizeOperations)}
-        
-        ## Action Endpoint Designs for Review (YOUR TASK)
-
-        ⚠️ CRITICAL: You MUST provide a revision for EVERY endpoint listed below.
-
-        - Use **keep** to approve endpoints that are correct
-        - Use **update** to fix endpoints with issues
-        - Use **erase** to remove invalid endpoints
-        - Use **create** to add missing endpoints
-
-        DO NOT omit any endpoint. DO NOT reference endpoints not listed here.
-
-        \`\`\`json
-        ${JSON.stringify(props.designs)}
-        \`\`\`
-
-        Review according to the criteria in the system prompt. Call \`process()\` with \`type: "complete"\` containing all \`revises\`.
-      `,
-      created_at: new Date().toISOString(),
-    },
-  ],
-  userMessage: `Review the action endpoints for the ${props.group.name} group and fix any issues found.`,
-});
+import {
+  AutoBeInterfaceEndpointDesign,
+  AutoBeInterfaceGroup,
+  AutoBeOpenApi,
+} from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
+import { transformInterfaceEndpointAuthorizationSection } from "./transformInterfaceEndpointAuthorizationSection";
+
+export const transformInterfaceActionEndpointReviewHistory = (props: {
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+    | "previousInterfaceOperations"
+  >;
+  designs: AutoBeInterfaceEndpointDesign[];
+  baseEndpoints: AutoBeOpenApi.IEndpoint[];
+  group: AutoBeInterfaceGroup;
+  authorizeOperations: AutoBeOpenApi.IOperation[];
+}): IAutoBeOrchestrateHistory => ({
+  histories: [
+    {
+      type: "systemMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: AutoBeSystemPromptConstant.INTERFACE_ACTION_ENDPOINT_WRITE,
+    },
+    {
+      type: "systemMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: AutoBeSystemPromptConstant.INTERFACE_ACTION_ENDPOINT_REVIEW,
+    },
+    ...props.preliminary.getHistories(),
+    {
+      id: v7(),
+      type: "assistantMessage",
+      text: StringUtil.trim`
+        ## Base CRUD Endpoints (Reference - Already Exist)
+
+        These base CRUD endpoints already exist. For reference only:
+
+        \`\`\`json
+        ${JSON.stringify(props.baseEndpoints)}
+        \`\`\`
+
+        ## Target Group
+
+        You are reviewing endpoints for the **${props.group.name}** group.
+
+        - **Description**: ${props.group.description}
+        - **Related Database Schemas**: ${props.group.databaseSchemas.join(", ")}
+
+        ${transformInterfaceEndpointAuthorizationSection(props.authorizeOperations)}
+        
+        ## Action Endpoint Designs for Review (YOUR TASK)
+
+        ⚠️ CRITICAL: You MUST provide a revision for EVERY endpoint listed below.
+
+        - Use **keep** to approve endpoints that are correct
+        - Use **update** to fix endpoints with issues
+        - Use **erase** to remove invalid endpoints
+        - Use **create** to add missing endpoints
+
+        DO NOT omit any endpoint. DO NOT reference endpoints not listed here.
+
+        \`\`\`json
+        ${JSON.stringify(props.designs)}
+        \`\`\`
+
+        Review according to the criteria in the system prompt. Call \`process()\` with \`type: "complete"\` containing all \`revises\`.
+      `,
+      created_at: new Date().toISOString(),
+    },
+  ],
+  userMessage: `Review the action endpoints for the ${props.group.name} group and fix any issues found.`,
+});