@autobe/agent 0.28.0 → 0.29.0

package/src/orchestrate/realize/structures/IAutoBeRealizeAuthorizationCorrectApplication.ts

@@ -1,34 +1,72 @@
-import { IAutoBeRealizeAuthorizationApplication } from "./IAutoBeRealizeAuthorizationApplication";
+import { IAutoBePreliminaryGetPrismaSchemas } from "../../common/structures/IAutoBePreliminaryGetPrismaSchemas";
+import { IAutoBeRealizeAuthorizationWriteApplication } from "./IAutoBeRealizeAuthorizationWriteApplication";
 
 export interface IAutoBeRealizeAuthorizationCorrectApplication {
   /**
-   * Corrects TypeScript compilation errors in authentication components.
+   * Process authentication component correction task or preliminary data
+   * requests.
    *
-   * This method analyzes and fixes compilation errors in previously generated
-   * authentication provider, decorator, and payload type implementations. It
-   * performs systematic error diagnosis and generates corrected versions of
-   * all three components while maintaining their interconnected functionality.
+   * Fixes TypeScript compilation errors in authentication components through
+   * systematic error diagnosis. Provides error analysis, solution guidance, and
+   * corrected versions while preserving authentication logic.
    *
-   * The correction process includes:
-   * - TypeScript error analysis and categorization by component
-   * - Identification of type mismatches, import issues, and syntax errors
-   * - Clear solution guidance for each identified problem
-   * - Regeneration of all components with fixes applied
-   *
-   * The corrected components maintain the same naming conventions and
-   * architectural patterns as the original generation while resolving all
-   * compilation issues.
-   *
-   * @param next Properties containing error analysis, solution guidance, and corrected components
+   * @param next Request containing either preliminary data request or complete
+   *   task
    */
-  correctDecorator: (
-    next: IAutoBeRealizeAuthorizationCorrectApplication.IProps,
-  ) => void;
+  process(next: IAutoBeRealizeAuthorizationCorrectApplication.IProps): void;
 }
 
 export namespace IAutoBeRealizeAuthorizationCorrectApplication {
-  export interface IProps
-    extends IAutoBeRealizeAuthorizationApplication.IProps {
+  export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on your
+     * current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisFiles, getPrismaSchemas, etc.):
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getPrismaSchemas) or final error correction (complete). When preliminary
+     * returns empty array, that type is removed from the union, physically
+     * preventing repeated calls.
+     */
+    request: IComplete | IAutoBePreliminaryGetPrismaSchemas;
+  }
+
+  /**
+   * Request to fix authentication component errors.
+   *
+   * Executes targeted error correction to resolve TypeScript compilation issues
+   * in provider, decorator, and payload type. Applies systematic fixes while
+   * preserving all authentication logic and business requirements.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final task
+     * execution request.
+     */
+    type: "complete";
+
     /**
      * Step 1: TypeScript compilation error analysis and diagnosis.
      *
@@ -49,5 +87,30 @@ export namespace IAutoBeRealizeAuthorizationCorrectApplication {
      * implementations.
      */
     solution_guidance: string;
+
+    /**
+     * Authentication Provider function configuration containing the function
+     * name and implementation code. The Provider handles JWT token
+     * verification, role validation, and database queries to authenticate
+     * users.
+     */
+    provider: IAutoBeRealizeAuthorizationWriteApplication.IProvider;
+
+    /**
+     * Authentication Decorator configuration containing the decorator name and
+     * implementation code. The Decorator integrates with NestJS parameter
+     * decorators to automatically inject authenticated user data into
+     * Controller methods.
+     */
+    decorator: IAutoBeRealizeAuthorizationWriteApplication.IDecorator;
+
+    /**
+     * Authentication Payload Type configuration containing the payload type
+     * name and implementation code. The Payload Type is used to define the
+     * structure of the authenticated user data that will be injected into
+     * Controller methods when using the decorator. It serves as the TypeScript
+     * type for the parameter in Controller method signatures.
+     */
+    payload: IAutoBeRealizeAuthorizationWriteApplication.IPayloadType;
   }
 }

package/src/orchestrate/realize/structures/{IAutoBeRealizeAuthorizationApplication.ts → IAutoBeRealizeAuthorizationWriteApplication.ts}

@@ -1,45 +1,80 @@
 import { CamelCasePattern, PascalCasePattern } from "@autobe/interface";
 
-export interface IAutoBeRealizeAuthorizationApplication {
+import { IAutoBePreliminaryGetPrismaSchemas } from "../../common/structures/IAutoBePreliminaryGetPrismaSchemas";
+
+export interface IAutoBeRealizeAuthorizationWriteApplication {
   /**
-   * Generates authentication provider, decorator, and payload type for
-   * role-based authorization.
-   *
-   * This method creates a complete authentication infrastructure for a specific
-   * role in the NestJS application. It generates three interconnected
-   * components that work together to provide JWT-based authentication and
-   * authorization.
-   *
-   * The generated components include:
+   * Process authentication component generation task or preliminary data
+   * requests.
    *
-   * - **Provider Function**: Handles JWT verification and user validation from
-   *   database
-   * - **Decorator**: NestJS parameter decorator for injecting authenticated user
-   *   data
-   * - **Payload Type**: TypeScript interface defining the authenticated user
-   *   structure
+   * Generates JWT-based authentication infrastructure (provider, decorator,
+   * payload) for role-based authorization. Integrates with NestJS patterns and
+   * jwtAuthorize utility.
    *
-   * All components follow strict naming conventions and integrate with the
-   * existing authentication architecture using the shared jwtAuthorize
-   * function.
-   *
-   * @param next Properties containing provider, decorator, and payload type
-   *   configurations
+   * @param next Request containing either preliminary data request or complete
+   *   task
    */
-  createDecorator: (
-    next: IAutoBeRealizeAuthorizationApplication.IProps,
-  ) => void;
+  process(next: IAutoBeRealizeAuthorizationWriteApplication.IProps): void;
 }
 
-export namespace IAutoBeRealizeAuthorizationApplication {
+export namespace IAutoBeRealizeAuthorizationWriteApplication {
   export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on your
+     * current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisFiles, getPrismaSchemas, etc.):
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getPrismaSchemas) or final authentication generation (complete). When
+     * preliminary returns empty array, that type is removed from the union,
+     * physically preventing repeated calls.
+     */
+    request: IComplete | IAutoBePreliminaryGetPrismaSchemas;
+  }
+
+  /**
+   * Request to generate authentication components.
+   *
+   * Executes authentication generation to create provider function, decorator,
+   * and payload type for the specified role. All components work together to
+   * provide JWT-based authentication and authorization.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final task
+     * execution request.
+     */
+    type: "complete";
+
     /**
      * Authentication Provider function configuration containing the function
      * name and implementation code. The Provider handles JWT token
      * verification, role validation, and database queries to authenticate
      * users.
      */
-    provider: IAutoBeRealizeAuthorizationApplication.IProvider;
+    provider: IAutoBeRealizeAuthorizationWriteApplication.IProvider;
 
     /**
      * Authentication Decorator configuration containing the decorator name and
@@ -47,7 +82,7 @@ export namespace IAutoBeRealizeAuthorizationApplication {
      * decorators to automatically inject authenticated user data into
      * Controller methods.
      */
-    decorator: IAutoBeRealizeAuthorizationApplication.IDecorator;
+    decorator: IAutoBeRealizeAuthorizationWriteApplication.IDecorator;
 
     /**
      * Authentication Payload Type configuration containing the payload type
@@ -56,7 +91,7 @@ export namespace IAutoBeRealizeAuthorizationApplication {
      * Controller methods when using the decorator. It serves as the TypeScript
      * type for the parameter in Controller method signatures.
      */
-    payload: IAutoBeRealizeAuthorizationApplication.IPayloadType;
+    payload: IAutoBeRealizeAuthorizationWriteApplication.IPayloadType;
   }
 
   export interface IProvider {

package/src/orchestrate/realize/structures/IAutoBeRealizeCorrectApplication.ts

@@ -1,17 +1,70 @@
+import { IAutoBePreliminaryGetPrismaSchemas } from "../../common/structures/IAutoBePreliminaryGetPrismaSchemas";
+
 export interface IAutoBeRealizeCorrectApplication {
   /**
-   * Systematically analyze and correct TypeScript compilation errors.
+   * Process provider correction task or preliminary data requests.
    *
-   * Implements a three-phase workflow (think → draft → revise) that balances
-   * efficiency for simple errors with thoroughness for complex problems.
+   * Systematically analyzes and corrects TypeScript compilation errors through
+   * three-phase workflow (think → draft → revise). Maintains business logic
+   * integrity while resolving all compilation issues.
    *
-   * @param props Three-phase correction properties
+   * @param props Request containing either preliminary data request or complete
+   *   task
    */
-  correct(props: IAutoBeRealizeCorrectApplication.IProps): void;
+  process(props: IAutoBeRealizeCorrectApplication.IProps): void;
 }
 
 export namespace IAutoBeRealizeCorrectApplication {
   export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on your
+     * current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisFiles, getPrismaSchemas, etc.):
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getPrismaSchemas) or final error correction (complete). When preliminary
+     * returns empty array, that type is removed from the union, physically
+     * preventing repeated calls.
+     */
+    request: IComplete | IAutoBePreliminaryGetPrismaSchemas;
+  }
+
+  /**
+   * Request to correct provider implementation errors.
+   *
+   * Executes three-phase error correction to resolve TypeScript compilation
+   * issues in provider functions. Applies systematic fixes following think →
+   * draft → revise pattern to ensure error-free production code.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final task
+     * execution request.
+     */
+    type: "complete";
+
     /**
      * Initial error analysis and correction strategy.
      *

package/src/orchestrate/realize/structures/IAutoBeRealizeScenarioResult.ts

@@ -1,8 +1,4 @@
-import {
-  AutoBeOpenApi,
-  AutoBeRealizeAuthorization,
-  AutoBeTestFile,
-} from "@autobe/interface";
+import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
 
 export interface IAutoBeRealizeScenarioResult {
   /** The OpenAPI operation to be realized. */
@@ -11,12 +7,12 @@ export interface IAutoBeRealizeScenarioResult {
   /**
    * The name of the function to be generated.
    *
-   * Derived from the Swagger path and method. The function name must be
-   * written in snake_case. It serves as the entry point in both code
-   * generation and test code.
+   * Derived from the Swagger path and method. The function name must be written
+   * in snake_case. It serves as the entry point in both code generation and
+   * test code.
    *
-   * Once the function is generated, the function name and file name will be
-   * the same. The generated file will be located at
+   * Once the function is generated, the function name and file name will be the
+   * same. The generated file will be located at
    * `src/providers/${function_name}.ts`.
    */
   functionName: string;
@@ -24,15 +20,6 @@ export interface IAutoBeRealizeScenarioResult {
   /** For example, `src/providers/${function_name}.ts`. */
   location: string;
 
-  /**
-   * List of scenario descriptions for test code generation.
-   *
-   * Each scenario describes the expected behavior of the function under
-   * certain conditions. Used as a basis for TDD-style automated test
-   * generation.
-   */
-  testFiles: AutoBeTestFile[];
-
   /**
    * Optional decorator event for customizing code generation behavior.
    *

package/src/orchestrate/realize/structures/IAutoBeRealizeWriteApplication.ts

@@ -1,18 +1,70 @@
+import { IAutoBePreliminaryGetPrismaSchemas } from "../../common/structures/IAutoBePreliminaryGetPrismaSchemas";
+
 export interface IAutoBeRealizeWriteApplication {
   /**
-   * Generate complete provider function implementation using Chain of Thinking.
-   *
-   * Follows a 3-phase process: plan → draft → revise.
+   * Process provider implementation task or preliminary data requests.
    *
-   * Ensures type safety, proper Prisma usage, and API contract compliance.
+   * Generates complete provider function implementation through three-phase
+   * workflow (plan → draft → revise). Ensures type safety, proper Prisma usage,
+   * and API contract compliance.
    *
-   * @param props Chain of Thinking properties for implementation
+   * @param props Request containing either preliminary data request or complete
+   *   task
    */
-  write(props: IAutoBeRealizeWriteApplication.IProps): void;
+  process(props: IAutoBeRealizeWriteApplication.IProps): void;
 }
 
 export namespace IAutoBeRealizeWriteApplication {
   export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on your
+     * current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisFiles, getPrismaSchemas, etc.):
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getPrismaSchemas) or final implementation generation (complete). When
+     * preliminary returns empty array, that type is removed from the union,
+     * physically preventing repeated calls.
+     */
+    request: IComplete | IAutoBePreliminaryGetPrismaSchemas;
+  }
+
+  /**
+   * Request to generate provider function implementation.
+   *
+   * Executes three-phase generation to create complete provider implementation.
+   * Follows plan → draft → revise pattern to ensure type safety, proper Prisma
+   * usage, and API contract compliance.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final task
+     * execution request.
+     */
+    type: "complete";
+
     /**
      * Implementation plan and strategy.
      *

package/src/orchestrate/realize/utils/generateRealizeScenario.ts

@@ -1,11 +1,5 @@
-import {
-  AutoBeOpenApi,
-  AutoBeRealizeAuthorization,
-  AutoBeTestFile,
-} from "@autobe/interface";
-import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
 
-import { AutoBeContext } from "../../../context/AutoBeContext";
 import { IAutoBeRealizeScenarioResult } from "../structures/IAutoBeRealizeScenarioResult";
 
 /**
@@ -28,31 +22,19 @@ import { IAutoBeRealizeScenarioResult } from "../structures/IAutoBeRealizeScenar
  * @returns A scenario object containing all structural information needed to
  *   generate the function
  */
-export function generateRealizeScenario<Model extends ILlmSchema.Model>(
-  ctx: AutoBeContext<Model>,
+export function generateRealizeScenario(
   operation: AutoBeOpenApi.IOperation,
   authorizations: AutoBeRealizeAuthorization[],
 ): IAutoBeRealizeScenarioResult {
   const authorization = authorizations.find(
     (el) => el.actor.name === operation.authorizationActor,
   );
-
-  const testFiles: AutoBeTestFile[] =
-    ctx
-      .state()
-      .test?.files.filter(
-        (el) =>
-          el.scenario.endpoint.method === operation.method &&
-          el.scenario.endpoint.path === operation.path,
-      ) ?? [];
-
   const functionName: string = transformFunctionName(operation);
 
   return {
     operation: operation,
     functionName: functionName,
     location: `src/providers/${functionName}.ts`,
-    testFiles: testFiles,
     decoratorEvent: authorization,
   };
 }

package/src/orchestrate/test/histories/transformTestCorrectHistories.ts

@@ -1,15 +1,15 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
 import { ILlmSchema } from "@samchon/openapi";
 import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeContext } from "../../../context/AutoBeContext";
-import { transformPreviousAndLatestCorrectHistories } from "../../common/histories/transformPreviousAndLatestCorrectHistories";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { transformPreviousAndLatestCorrectHistory } from "../../common/histories/transformPreviousAndLatestCorrectHistory";
 import { IAutoBeTestFunction } from "../structures/IAutoBeTestFunction";
 import { IAutoBeTestFunctionFailure } from "../structures/IAutoBeTestFunctionFailure";
-import { transformTestWriteHistories } from "./transformTestWriteHistories";
+import { transformTestWriteHistory } from "./transformTestWriteHistory";
 
-export const transformTestCorrectHistories = async <
+export const transformTestCorrectHistory = async <
   Model extends ILlmSchema.Model,
 >(
   ctx: AutoBeContext<Model>,
@@ -18,32 +18,32 @@ export const transformTestCorrectHistories = async <
     function: IAutoBeTestFunction;
     failures: IAutoBeTestFunctionFailure[];
   },
-): Promise<
-  Array<
-    IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-  >
-> => {
-  const previous: Array<
-    IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-  > = await transformTestWriteHistories(ctx, {
-    instruction: props.instruction,
-    scenario: props.function.scenario,
-    artifacts: props.function.artifacts,
-  });
-  return [
-    ...previous.slice(0, -1),
+): Promise<IAutoBeOrchestrateHistory> => {
+  const previous: IAutoBeOrchestrateHistory = await transformTestWriteHistory(
+    ctx,
     {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.TEST_CORRECT,
+      instruction: props.instruction,
+      scenario: props.function.scenario,
+      artifacts: props.function.artifacts,
     },
-    previous.at(-1)!,
-    ...transformPreviousAndLatestCorrectHistories(
-      props.failures.map((f) => ({
-        script: f.function.script,
-        diagnostics: f.failure.diagnostics,
-      })),
-    ),
-  ];
+  );
+  return {
+    histories: [
+      ...previous.histories.slice(0, -1),
+      {
+        id: v7(),
+        created_at: new Date().toISOString(),
+        type: "systemMessage",
+        text: AutoBeSystemPromptConstant.TEST_CORRECT,
+      },
+      previous.histories.at(-1)!,
+      ...transformPreviousAndLatestCorrectHistory(
+        props.failures.map((f) => ({
+          script: f.function.script,
+          diagnostics: f.failure.diagnostics,
+        })),
+      ),
+    ],
+    userMessage: "Fix the compile errors in the test code please",
+  };
 };

package/src/orchestrate/test/histories/transformTestCorrectInvalidRequestHistory.ts

@@ -0,0 +1,40 @@
+import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { IAutoBeTestFunction } from "../structures/IAutoBeTestFunction";
+
+export const transformTestCorrectInvalidRequestHistory = (
+  func: IAutoBeTestFunction,
+  diagnostics: IAutoBeTypeScriptCompileResult.IDiagnostic[],
+): IAutoBeOrchestrateHistory => ({
+  histories: [
+    {
+      id: v7(),
+      created_at: new Date().toISOString(),
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.TEST_CORRECT_INVALID_REQUEST,
+    },
+    {
+      id: v7(),
+      created_at: new Date().toISOString(),
+      type: "assistantMessage",
+      text: StringUtil.trim`
+        ## TypeScript Code
+
+        \`\`\`typescript
+        ${func.script}
+        \`\`\`
+
+        ## Compile Errors
+
+        \`\`\`json
+        ${JSON.stringify(diagnostics)}
+        \`\`\`
+      `,
+    },
+  ],
+  userMessage: "Fix the compile errors in the test code please",
+});