@autobe/agent 0.14.5 → 0.15.0

package/src/orchestrate/realize/orchestrateRealizeAuthorization.ts

@@ -5,18 +5,18 @@ import {
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
-import fs from "fs/promises";
-import path from "path";
 import { IPointer } from "tstl";
 import typia from "typia";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
 import { enforceToolCall } from "../../utils/enforceToolCall";
-import { IAutoBeRealizeDecoratorApplication } from "./structures/IAutoBeRealizeDecoratorApplication";
-import { transformRealizeDecoratorHistories } from "./transformRealizeDecorator";
-import { transformRealizeDecoratorCorrectHistories } from "./transformRealizeDecoratorCorrectHistories";
+import { orchestrateRealizeAuthorizationCorrect } from "./orchestrateRealizeAuthorizationCorrect";
+import { IAutoBeRealizeAuthorizationApplication } from "./structures/IAutoBeRealizeAuthorizationApplication";
+import { transformRealizeAuthorizationHistories } from "./transformRealizeAuthorization";
+import { transformRealizeAuthorizationCorrectHistories } from "./transformRealizeAuthorizationCorrectHistories";
 import { AuthorizationFileSystem } from "./utils/AuthorizationFileSystem";
+import { InternalFileSystem } from "./utils/InternalFileSystem";
 
 /**
  * 1. Create decorator and its parameters. and design the Authorization Provider.
@@ -35,34 +35,22 @@ export async function orchestrateRealizeAuthorization<
 
   let completed = 0;
 
-  const templateFiles = {
-    "src/MyGlobal.ts": await fs.readFile(
-      path.join(
-        __dirname,
-        "../../../../../internals/template/realize/src/MyGlobal.ts",
-      ),
-      "utf-8",
-    ),
-    "src/authentications/jwtAuthorize.ts": await fs.readFile(
-      path.join(
-        __dirname,
-        "../../../../../internals/template/realize/src/providers/jwtAuthorize.ts",
-      ),
-      "utf-8",
-    ),
-  };
+  const templateFiles = await (await ctx.compiler()).realize.getTemplate();
 
   ctx.dispatch({
     type: "realizeAuthorizationStart",
     step: ctx.state().test?.step ?? 0,
     created_at: new Date().toISOString(),
   });
+
   const authorizations: AutoBeRealizeAuthorization[] = await Promise.all(
     roles.map(async (role) => {
       const authorization: AutoBeRealizeAuthorization = await process(
         ctx,
         role,
-        templateFiles,
+        InternalFileSystem.DEFAULT.map((el) => ({
+          [el]: templateFiles[el],
+        })).reduce((acc, cur) => Object.assign(acc, cur), {}),
       );
       ctx.dispatch({
         type: "realizeAuthorizationWrite",
@@ -88,9 +76,10 @@ async function process<Model extends ILlmSchema.Model>(
   role: string,
   templateFiles: Record<string, string>,
 ): Promise<AutoBeRealizeAuthorization> {
-  const pointer: IPointer<IAutoBeRealizeDecoratorApplication.IProps | null> = {
-    value: null,
-  };
+  const pointer: IPointer<IAutoBeRealizeAuthorizationApplication.IProps | null> =
+    {
+      value: null,
+    };
   const agentica: MicroAgentica<Model> = new MicroAgentica({
     model: ctx.model,
     vendor: ctx.vendor,
@@ -100,7 +89,7 @@ async function process<Model extends ILlmSchema.Model>(
         describe: null,
       },
     },
-    histories: transformRealizeDecoratorHistories(ctx, role),
+    histories: transformRealizeAuthorizationHistories(ctx, role),
     controllers: [
       createApplication({
         model: ctx.model,
@@ -127,24 +116,25 @@ async function process<Model extends ILlmSchema.Model>(
         pointer.value.decorator.name,
       ),
       name: pointer.value.decorator.name,
-      content: pointer.value.decorator.code,
+      content: pointer.value.decorator.content,
     },
     payload: {
       location: AuthorizationFileSystem.payloadPath(pointer.value.payload.name),
       name: pointer.value.payload.name,
-      content: pointer.value.payload.code,
+      content: pointer.value.payload.content,
     },
     provider: {
       location: AuthorizationFileSystem.providerPath(
         pointer.value.provider.name,
       ),
       name: pointer.value.provider.name,
-      content: pointer.value.provider.code,
+      content: pointer.value.provider.content,
     },
   };
   const compiled = ctx.state().prisma?.compiled;
   const prismaClients: Record<string, string> =
     compiled?.type === "success" ? compiled.nodeModules : {};
+
   return correctDecorator(ctx, authorization, prismaClients, templateFiles);
 }
 
@@ -182,9 +172,10 @@ async function correctDecorator<Model extends ILlmSchema.Model>(
     return auth;
   }
 
-  const pointer: IPointer<IAutoBeRealizeDecoratorApplication.IProps | null> = {
-    value: null,
-  };
+  const pointer: IPointer<IAutoBeRealizeAuthorizationApplication.IProps | null> =
+    {
+      value: null,
+    };
   const agentica: MicroAgentica<Model> = new MicroAgentica({
     model: ctx.model,
     vendor: ctx.vendor,
@@ -194,7 +185,7 @@ async function correctDecorator<Model extends ILlmSchema.Model>(
         describe: null,
       },
     },
-    histories: transformRealizeDecoratorCorrectHistories(
+    histories: transformRealizeAuthorizationCorrectHistories(
       ctx,
       auth,
       templateFiles,
@@ -225,38 +216,38 @@ async function correctDecorator<Model extends ILlmSchema.Model>(
     decorator: {
       location: auth.decorator.location,
       name: pointer.value.decorator.name,
-      content: pointer.value.decorator.code,
+      content: pointer.value.decorator.content,
     },
     payload: {
       location: auth.payload.location,
       name: pointer.value.payload.name,
-      content: pointer.value.payload.code,
+      content: pointer.value.payload.content,
     },
     provider: {
       location: auth.provider.location,
       name: pointer.value.provider.name,
-      content: pointer.value.provider.code,
+      content: pointer.value.provider.content,
     },
   };
-  ctx.dispatch({
-    type: "realizeAuthorizationCorrect",
-    created_at: new Date().toISOString(),
-    authorization: corrected,
-    result: result,
-    step: ctx.state().test?.step ?? 0,
-  });
-  return await correctDecorator(
-    ctx,
-    corrected,
-    prismaClients,
-    templateFiles,
-    life - 1,
-  );
+
+  const res: AutoBeRealizeAuthorization =
+    await orchestrateRealizeAuthorizationCorrect(
+      ctx,
+      corrected,
+      prismaClients,
+      templateFiles,
+      life - 1,
+    );
+
+  return {
+    ...res,
+    role: auth.role,
+  };
 }
 
 function createApplication<Model extends ILlmSchema.Model>(props: {
   model: Model;
-  build: (next: IAutoBeRealizeDecoratorApplication.IProps) => void;
+  build: (next: IAutoBeRealizeAuthorizationApplication.IProps) => void;
 }): IAgenticaController.IClass<Model> {
   assertSchemaModel(props.model);
 
@@ -272,12 +263,12 @@ function createApplication<Model extends ILlmSchema.Model>(props: {
       createDecorator: (next) => {
         props.build(next);
       },
-    } satisfies IAutoBeRealizeDecoratorApplication,
+    } satisfies IAutoBeRealizeAuthorizationApplication,
   };
 }
 
 const claude = typia.llm.application<
-  IAutoBeRealizeDecoratorApplication,
+  IAutoBeRealizeAuthorizationApplication,
   "claude",
   {
     reference: true;
@@ -285,7 +276,7 @@ const claude = typia.llm.application<
 >();
 const collection = {
   chatgpt: typia.llm.application<
-    IAutoBeRealizeDecoratorApplication,
+    IAutoBeRealizeAuthorizationApplication,
     "chatgpt",
     { reference: true }
   >(),

package/src/orchestrate/realize/orchestrateRealizeAuthorizationCorrect.ts

@@ -0,0 +1,179 @@
+import { IAgenticaController, MicroAgentica } from "@agentica/core";
+import {
+  AutoBeRealizeAuthorization,
+  AutoBeRealizeAuthorizationCorrect,
+  IAutoBeCompiler,
+  IAutoBeTypeScriptCompileResult,
+} from "@autobe/interface";
+import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
+import { IPointer } from "tstl";
+import typia from "typia";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { assertSchemaModel } from "../../context/assertSchemaModel";
+import { enforceToolCall } from "../../utils/enforceToolCall";
+import { IAutoBeRealizeAuthorizationCorrectApplication } from "./structures/IAutoBeRealizeAuthorizationCorrectApplication";
+import { transformRealizeAuthorizationCorrectHistories } from "./transformRealizeAuthorizationCorrectHistories";
+import { AuthorizationFileSystem } from "./utils/AuthorizationFileSystem";
+
+export async function orchestrateRealizeAuthorizationCorrect<
+  Model extends ILlmSchema.Model,
+>(
+  ctx: AutoBeContext<Model>,
+  authorization: AutoBeRealizeAuthorization,
+  prismaClients: Record<string, string>,
+  templateFiles: Record<string, string>,
+  life: number = 4,
+): Promise<AutoBeRealizeAuthorization> {
+  // Check Compile
+  const files: Record<string, string> = {
+    ...templateFiles,
+    ...prismaClients,
+    [AuthorizationFileSystem.decoratorPath(authorization.decorator.name)]:
+      authorization.decorator.content,
+    [AuthorizationFileSystem.providerPath(authorization.provider.name)]:
+      authorization.provider.content,
+    [AuthorizationFileSystem.payloadPath(authorization.payload.name)]:
+      authorization.payload.content,
+  };
+
+  const compiler: IAutoBeCompiler = await ctx.compiler();
+
+  const compiled: IAutoBeTypeScriptCompileResult =
+    await compiler.typescript.compile({
+      files,
+    });
+
+  ctx.dispatch({
+    type: "realizeAuthorizationValidate",
+    created_at: new Date().toISOString(),
+    authorization: authorization,
+    result: compiled,
+    step: ctx.state().test?.step ?? 0,
+  });
+
+  if (compiled.type === "success") {
+    return authorization;
+  } else if (compiled.type === "exception" || life === 0) {
+    return authorization;
+  }
+
+  const pointer: IPointer<IAutoBeRealizeAuthorizationCorrectApplication.IProps | null> =
+    {
+      value: null,
+    };
+
+  const agentica: MicroAgentica<Model> = new MicroAgentica({
+    model: ctx.model,
+    vendor: ctx.vendor,
+    config: {
+      ...(ctx.config ?? {}),
+      executor: {
+        describe: null,
+      },
+    },
+    histories: transformRealizeAuthorizationCorrectHistories(
+      ctx,
+      authorization,
+      templateFiles,
+      compiled.diagnostics,
+    ),
+    controllers: [
+      createApplication({
+        model: ctx.model,
+        build: (next) => {
+          pointer.value = next;
+        },
+      }),
+    ],
+  });
+  enforceToolCall(agentica);
+
+  await agentica
+    .conversate("Please correct the decorator and the provider.")
+    .finally(() => {
+      const tokenUsage = agentica.getTokenUsage();
+      ctx.usage().record(tokenUsage, ["realize"]);
+    });
+
+  if (pointer.value === null) throw new Error("Failed to correct decorator.");
+
+  const result: AutoBeRealizeAuthorizationCorrect = {
+    ...pointer.value,
+    decorator: {
+      ...pointer.value.decorator,
+      location: AuthorizationFileSystem.decoratorPath(
+        pointer.value.decorator.name,
+      ),
+    },
+    provider: {
+      ...pointer.value.provider,
+      location: AuthorizationFileSystem.providerPath(
+        pointer.value.provider.name,
+      ),
+    },
+    payload: {
+      ...pointer.value.payload,
+      location: AuthorizationFileSystem.payloadPath(pointer.value.payload.name),
+    },
+    role: authorization.role,
+  };
+
+  ctx.dispatch({
+    ...pointer.value,
+    type: "realizeAuthorizationCorrect",
+    created_at: new Date().toISOString(),
+    authorization: result,
+    result: compiled,
+    step: ctx.state().test?.step ?? 0,
+  });
+
+  return await orchestrateRealizeAuthorizationCorrect(
+    ctx,
+    result,
+    prismaClients,
+    templateFiles,
+    life - 1,
+  );
+}
+
+function createApplication<Model extends ILlmSchema.Model>(props: {
+  model: Model;
+  build: (next: IAutoBeRealizeAuthorizationCorrectApplication.IProps) => void;
+}): IAgenticaController.IClass<Model> {
+  assertSchemaModel(props.model);
+
+  const application: ILlmApplication<Model> = collection[
+    props.model
+  ] as unknown as ILlmApplication<Model>;
+
+  return {
+    protocol: "class",
+    name: "Correct Authorization",
+    application,
+    execute: {
+      correctDecorator: (next) => {
+        props.build(next);
+      },
+    } satisfies IAutoBeRealizeAuthorizationCorrectApplication,
+  };
+}
+
+const claude = typia.llm.application<
+  IAutoBeRealizeAuthorizationCorrectApplication,
+  "claude",
+  {
+    reference: true;
+  }
+>();
+const collection = {
+  chatgpt: typia.llm.application<
+    IAutoBeRealizeAuthorizationCorrectApplication,
+    "chatgpt",
+    { reference: true }
+  >(),
+  claude,
+  llama: claude,
+  deepseek: claude,
+  "3.1": claude,
+};

package/src/orchestrate/realize/orchestrateRealizeCoder.ts

@@ -9,10 +9,7 @@ import typia from "typia";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
-import {
-  randomBackoffRetry,
-  randomBackoffStrategy,
-} from "../../utils/backoffRetry";
+import { randomBackoffRetry } from "../../utils/backoffRetry";
 import { enforceToolCall } from "../../utils/enforceToolCall";
 import { getTestScenarioArtifacts } from "../test/compile/getTestScenarioArtifacts";
 import { IAutoBeTestScenarioArtifacts } from "../test/structures/IAutoBeTestScenarioArtifacts";
@@ -20,6 +17,7 @@ import { RealizePlannerOutput } from "./orchestrateRealizePlanner";
 import { IAutoBeRealizeCoderApplication } from "./structures/IAutoBeRealizeCoderApplication";
 import { FAILED } from "./structures/IAutoBeRealizeFailedSymbol";
 import { transformRealizeCoderHistories } from "./transformRealizeCoderHistories";
+import { RealizeFileSystem } from "./utils/ProviderFileSystem";
 import { replaceImportStatements } from "./utils/replaceImportStatements";
 
 /**
@@ -85,7 +83,6 @@ export const orchestrateRealizeCoder = async <Model extends ILlmSchema.Model>(
     vendor: ctx.vendor,
     config: {
       ...ctx.config,
-      backoffStrategy: randomBackoffStrategy,
       executor: {
         describe: null,
       },
@@ -138,7 +135,7 @@ export const orchestrateRealizeCoder = async <Model extends ILlmSchema.Model>(
 
   return {
     ...pointer.value,
-    filename: `src/providers/${props.functionName}.ts`,
+    filename: RealizeFileSystem.providerPath(props.functionName),
   };
 };
 

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

@@ -1,8 +1,10 @@
-export interface IAutoBeRealizeDecoratorApplication {
-  createDecorator: (next: IAutoBeRealizeDecoratorApplication.IProps) => void;
+export interface IAutoBeRealizeAuthorizationApplication {
+  createDecorator: (
+    next: IAutoBeRealizeAuthorizationApplication.IProps,
+  ) => void;
 }
 
-export namespace IAutoBeRealizeDecoratorApplication {
+export namespace IAutoBeRealizeAuthorizationApplication {
   export interface IProps {
     /**
      * Authentication Provider function configuration containing the function
@@ -10,7 +12,7 @@ export namespace IAutoBeRealizeDecoratorApplication {
      * verification, role validation, and database queries to authenticate
      * users.
      */
-    provider: IAutoBeRealizeDecoratorApplication.IProvider;
+    provider: IAutoBeRealizeAuthorizationApplication.IProvider;
 
     /**
      * Authentication Decorator configuration containing the decorator name and
@@ -18,7 +20,7 @@ export namespace IAutoBeRealizeDecoratorApplication {
      * decorators to automatically inject authenticated user data into
      * Controller methods.
      */
-    decorator: IAutoBeRealizeDecoratorApplication.IDecorator;
+    decorator: IAutoBeRealizeAuthorizationApplication.IDecorator;
 
     /**
      * Authentication Payload Type configuration containing the payload type
@@ -27,7 +29,7 @@ export namespace IAutoBeRealizeDecoratorApplication {
      * Controller methods when using the decorator. It serves as the TypeScript
      * type for the parameter in Controller method signatures.
      */
-    payload: IAutoBeRealizeDecoratorApplication.IPayloadType;
+    payload: IAutoBeRealizeAuthorizationApplication.IPayloadType;
   }
 
   export interface IProvider {
@@ -48,7 +50,7 @@ export namespace IAutoBeRealizeDecoratorApplication {
      * UnauthorizedException, and the Payload interface definition with id (UUID
      * format) and type (role discriminator) fields using typia tags.
      */
-    code: string;
+    content: string;
   }
 
   export interface IDecorator {
@@ -69,7 +71,7 @@ export namespace IAutoBeRealizeDecoratorApplication {
      * pattern using tstl library for efficient decorator instance management,
      * and proper TypeScript typing for the ParameterDecorator interface.
      */
-    code: string;
+    content: string;
   }
 
   export interface IPayloadType {
@@ -89,6 +91,6 @@ export namespace IAutoBeRealizeDecoratorApplication {
      * when using the decorator. It serves as the TypeScript type for the
      * parameter in Controller method signatures.
      */
-    code: string;
+    content: string;
   }
 }

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

@@ -0,0 +1,40 @@
+import { IAutoBeRealizeAuthorizationApplication } from "./IAutoBeRealizeAuthorizationApplication";
+
+export interface IAutoBeRealizeAuthorizationCorrectApplication {
+  correctDecorator: (
+    next: IAutoBeRealizeAuthorizationCorrectApplication.IProps,
+  ) => void;
+}
+
+export namespace IAutoBeRealizeAuthorizationCorrectApplication {
+  export interface IProps
+    extends IAutoBeRealizeAuthorizationApplication.IProps {
+    /**
+     * Step 1: TypeScript compilation error analysis and diagnosis.
+     *
+     * AI identifies all compilation errors (type mismatches, imports, syntax)
+     * and categorizes them by component (providers/decorator/payload). Analyzes
+     * error dependencies and determines fix priorities for systematic
+     * resolution.
+     */
+    error_analysis: string;
+
+    /**
+     * Step 2: Corrected implementation with all compilation errors resolved.
+     *
+     * AI generates fixed versions of provider, decorator, and payload code.
+     * Maintains original functionality while ensuring TypeScript compilation
+     * success and proper NestJS/Prisma framework integration.
+     */
+    corrected_implementation: string;
+
+    /**
+     * Step 3: Final validation and comprehensive fix summary.
+     *
+     * AI validates corrected code compiles successfully and documents all
+     * changes made. Provides production-ready code with detailed change log for
+     * maintenance reference.
+     */
+    validation_summary: string;
+  }
+}

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

@@ -4,42 +4,60 @@ import {
 } from "@autobe/interface";
 import { tags } from "typia";
 
-import { IAutoBeRealizeCoderApplication } from "./IAutoBeRealizeCoderApplication";
 import { FAILED } from "./IAutoBeRealizeFailedSymbol";
 
 export namespace IAutoBeRealizeCompile {
-  export interface Success {
-    type: "success";
+  type IBase<T extends "success" | "failed"> = {
+    type: T;
+  };
+
+  interface IOperation {
+    /**
+     * Operation: An object containing the function specification including the
+     * endpoint
+     */
     op: AutoBeOpenApi.IOperation;
-    result: Pick<
-      IAutoBeRealizeCoderApplication.RealizeCoderOutput,
-      "filename" | "implementationCode"
-    > & {
-      /** Function name */
-      name: string;
-    };
   }
 
-  export interface Fail {
-    type: "failed";
-    op: AutoBeOpenApi.IOperation;
+  interface SuccessResult {
+    /** The name of the file where the implementation will be written */
+    filename: string;
+    /** The generated implementation code for the function */
+    implementationCode: string;
+    /** Function name */
+    name: string;
+  }
+
+  export interface Success extends IBase<"success">, IOperation {
+    result: SuccessResult;
+  }
+
+  export interface Fail extends IBase<"failed">, IOperation {
     result: FAILED;
   }
 
-  export type FileContentMap = Record<
-    string,
-    {
-      result: "failed" | "success";
-      content: string;
-      role?: (string & tags.MinLength<1>) | null;
-      endpoint?: AutoBeOpenApi.IEndpoint;
-      location?: string;
-      name?: string;
-    }
-  >;
+  export interface FileContentMapEntry {
+    result: "failed" | "success";
+    content: string;
+    role?: (string & tags.MinLength<1>) | null;
+    endpoint?: AutoBeOpenApi.IEndpoint;
+    location?: string;
+    name?: string;
+  }
+
+  export type FileContentMap = Record<string, FileContentMapEntry>;
 
   export interface CompileDiagnostics {
+    /**
+     * Array containing all errors including previous attempts. Includes errors
+     * that have already been resolved. Used to preserve error context and
+     * identify recurring error patterns.
+     */
     total: IAutoBeTypeScriptCompileResult.IDiagnostic[];
+    /**
+     * Array containing errors from the most recent code compilation. These are
+     * the errors that need to be resolved in the current iteration.
+     */
     current: IAutoBeTypeScriptCompileResult.IDiagnostic[];
   }
 }

package/src/orchestrate/realize/{transformRealizeDecorator.ts → transformRealizeAuthorization.ts}

@@ -4,8 +4,9 @@ import { v4 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
 import { AutoBeContext } from "../../context/AutoBeContext";
+import { AuthorizationFileSystem } from "./utils/AuthorizationFileSystem";
 
-export const transformRealizeDecoratorHistories = (
+export const transformRealizeAuthorizationHistories = (
   ctx: AutoBeContext<ILlmSchema.Model>,
   role: string,
 ): Array<
@@ -16,7 +17,7 @@ export const transformRealizeDecoratorHistories = (
       id: v4(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
-      text: AutoBeSystemPromptConstant.REALIZE_DECORATOR,
+      text: AutoBeSystemPromptConstant.REALIZE_AUTHORIZATION,
     },
     {
       id: v4(),
@@ -31,6 +32,16 @@ export const transformRealizeDecoratorHistories = (
         "",
         JSON.stringify(ctx.state().prisma?.schemas, null, 2),
         "",
+        "## File Structure Example",
+        "",
+        "Please refer to the following file structure to construct appropriate import paths:",
+        "",
+        "File locations:",
+        "",
+        `- Decorator Path : ${AuthorizationFileSystem.decoratorPath("AdminAuth.ts")}`,
+        `- Payload Path : ${AuthorizationFileSystem.payloadPath("AdminPayload.ts")}`,
+        `- Provider Path : ${AuthorizationFileSystem.providerPath("adminAuthorize.ts")}`,
+        "",
       ].join("\n"),
     },
   ];